hcalendar-issues: Difference between revisions

From Microformats Wiki
Jump to navigation Jump to search
No edit summary
 
Line 1: Line 1:
= hCalendar Issues =
= hCalendar Issues =


These are externally raised issues about ["hCalendar"] with broadly varying degrees of merit.  Thus some issues are REJECTED for a number of obvious reasons (but still documented here in case they are re-raised), and others contain longer discussions.  Some issues may be ACCEPTED and perhaps cause changes or improved explanations in the spec.  Submitted issues may (and probably will) be edited and rewritten for better terseness, clarity, calmness, rationality, and as neutral a point of view as possible. Write your issues well. — [http://tantek.com/log/ Tantek]
These are externally raised issues about [[hcalendar|hCalendar]] with broadly varying degrees of merit.  Thus some issues are REJECTED for a number of obvious reasons (but still documented here in case they are re-raised), and others contain longer discussions.  Some issues may be ACCEPTED and perhaps cause changes or improved explanations in the spec.  Submitted issues may (and probably will) be edited and rewritten for better terseness, clarity, calmness, rationality, and as neutral a point of view as possible. Write your issues well. — [http://tantek.com/log/ Tantek]


* 2005-02-22 Raised by Matt Raymond [http://listserver.dreamhost.com/pipermail/whatwg-whatwg.org/2005-February/003124.html on the whatwg list]:
* 2005-02-22 Raised by Matt Raymond [http://listserver.dreamhost.com/pipermail/whatwg-whatwg.org/2005-February/003124.html on the whatwg list]:
Line 21: Line 21:
*#* REJECTED (empty statements, invalid comparator).  Please state specific examples which show the perceived complexity.  The comparison "more complicated" requires two items, no second item was provided.
*#* REJECTED (empty statements, invalid comparator).  Please state specific examples which show the perceived complexity.  The comparison "more complicated" requires two items, no second item was provided.
*#  ''I dislike the entire system of using class names as markup.  Class names should be reserved for user-defined semantics.''
*#  ''I dislike the entire system of using class names as markup.  Class names should be reserved for user-defined semantics.''
*#* ACCEPT-PARTIAL.  When specific elements are available, they should be used instead of class names, but even then class names work well to "subclass" specific elements.  This is thoroughly discussed in the essay [http://tantek.com/log/2002/12.html#L20021216 A Touch of Class].  And yes, class names can and should be used for user-defined semantics. ["hCalendar"] is one such user, and it is reasonable for users to use each others class names.
*#* ACCEPT-PARTIAL.  When specific elements are available, they should be used instead of class names, but even then class names work well to "subclass" specific elements.  This is thoroughly discussed in the essay [http://tantek.com/log/2002/12.html#L20021216 A Touch of Class].  And yes, class names can and should be used for user-defined semantics. [[hcalendar|hCalendar]] is one such user, and it is reasonable for users to use each others class names.
*#* Would it be more in the spirit of HTML to define these classes in a [http://www.w3.org/TR/html401/struct/global.html#h-7.4.4.3 metadata profile], so that "User agents may... perform some activity based on known conventions for that profile"?  Should this be a part of MicroFormats specifications in general?  (If not, why not?)
 
* ''Would it be more in the spirit of HTML to define these classes in a [http://www.w3.org/TR/html401/struct/global.html#h-7.4.4.3 metadata profile], so that "User agents may... perform some activity based on known conventions for that profile"?  Should this be a part of [[microformats]] specifications in general?  (If not, why not?)''
** ACCEPTED.  Yes, all [[microformats]] that introduce new classnames SHOULD include an [http://gmpg.org/xmdp/ XMDP] profile (which itself is a microformat for defining HTML metadata profiles) that defines those classnames.

Revision as of 17:58, 19 June 2005

hCalendar Issues

These are externally raised issues about hCalendar with broadly varying degrees of merit. Thus some issues are REJECTED for a number of obvious reasons (but still documented here in case they are re-raised), and others contain longer discussions. Some issues may be ACCEPTED and perhaps cause changes or improved explanations in the spec. Submitted issues may (and probably will) be edited and rewritten for better terseness, clarity, calmness, rationality, and as neutral a point of view as possible. Write your issues well. — Tantek

  • 2005-02-22 Raised by Matt Raymond on the whatwg list:
    1. There is no copyright statement and no patent statement.
      • ACCEPTED. I have updated ["hCalendar"] (and ["hCard"], and all other MicroFormats) with a standard copyright statement and patent statement.
  • 2005-02-18 Raised by Matt Raymond on the whatwg list:
    1. There is no way for some reading the markup to tell if a class name is the name of an attribute or simply the name of a class used for styling.
      • REJECTED (strawman, poor assumption). There is no need to differentiate in the general case. In the specific case, a vocabulary is defined within a context.
    2. As a result of the above, user agents would not be able to reliably allow users to access extension properties such as "x-mozilla-alarm-default-length" (which is an actual extension used in Sunbird).
      • REJECTED (out of scope). Extension properties are outside the current scope of hCalendar.
    3. The use of for dates is incorrect. "August 5th, 2004" is not the abbreviation of 2004-09-05. In fact, the opposite is closer to the truth.
    4. You have to create a complex set of rules for all possible uses of legacy markup within which can easily be implemented incorrectly.
      • REJECTED (false statements, strawman). There is no legacy markup. There is no need to create rules for all possible uses of legacy markup. There is no need to create a complex set of rules.
      • There are styling and tooltip issues that are unresolved.
      • REJECTED (empty statements). See the ["hCalendarFAQ"] for answers to specific styling and tooltip questions. Otherwise, please raise specific issues here with clear valid examples.
    5. hCalendar/hCard is more complicated for webmasters to read and understand and more complicated for developers to implement.
      • REJECTED (empty statements, invalid comparator). Please state specific examples which show the perceived complexity. The comparison "more complicated" requires two items, no second item was provided.
    6. I dislike the entire system of using class names as markup. Class names should be reserved for user-defined semantics.
      • ACCEPT-PARTIAL. When specific elements are available, they should be used instead of class names, but even then class names work well to "subclass" specific elements. This is thoroughly discussed in the essay A Touch of Class. And yes, class names can and should be used for user-defined semantics. hCalendar is one such user, and it is reasonable for users to use each others class names.
  • Would it be more in the spirit of HTML to define these classes in a metadata profile, so that "User agents may... perform some activity based on known conventions for that profile"? Should this be a part of microformats specifications in general? (If not, why not?)
    • ACCEPTED. Yes, all microformats that introduce new classnames SHOULD include an XMDP profile (which itself is a microformat for defining HTML metadata profiles) that defines those classnames.