issues: Difference between revisions

From Microformats Wiki
Jump to navigation Jump to search
(→‎Miscellaneous issues: accessibility-issues;)
m (Replace <entry-title> with {{DISPLAYTITLE:}})
 
(29 intermediate revisions by 7 users not shown)
Line 1: Line 1:
<h1> Microformat Issues </h1>
{{DISPLAYTITLE: Microformat Issues }}
{{TOC-right}}
These are externally raised issues about microformats in general (these issues MUST apply to more than one microformat, which MUST be explicitly listed, otherwise the issue should be raised on the format specific issues page) 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]


As this is a general microformats issues page, please only note ''concrete'' real world issues.  Theoretical issues will be deleted, as will any issues raised that do not contain documentation of specific real-world examples that use real-world microformats (not just brainstorms).
These are externally raised issues about microformats in general.


Some issues may be ACCEPTED and perhaps cause changes or improved explanations in one or more specifications or microformats in general. Some issues may be REJECTED for a variety of brief reasons, and others contain longer discussions.
As this is a general microformats issues page, please only note ''concrete'' real world issues.  Theoretical issues may be deleted, as will any issues raised that do not contain documentation of specific real-world examples that use real-world microformats (not just brainstorms).
Please be sure that an issue applies to more than one microformat or pattern, otherwise the issue should be raised on the format/pattern specific issues page. Please check [[issues-resolved]] and [[issues-closed]] to first see if your issue has a resolution.
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]


== Closed Issues ==
== Closed Issues ==
Resolved issues that have no further actions to take. These will likely be moved to a separate page like [[microformats-issues-closed]].
Resolved issues that have no further actions to take.
* See [[issues-closed]]


* 2005-07-?? raised by Bud(?).
== Resolved Issues ==
*# ''Documents with user-generated content are hard to parse, and microformats present particular parsing challenges.''
Resolved issues that have outstanding [[to-do]] items.
*#* REJECTED. This is a straw man issue.
* See [[issues-resolved]]
* 2005-07-13T19:44-07:00 raised by [[User:Bud|Bud]]
 
*# Follow-up to previous issue: ''Tantek needs to supply some justification for why this is a strawman as every developer I have talked to has raised it. It may be that the solutions described below are sufficient to solve the issue. More neutral statements to that effect might be more constructive.''
== Issues ==
*#* REJECTED. Bud, saying "particular parsing challenges", without stating them is meaningless. Hence strawman. I think you may be mistaking questions for issues.
=== opened 2006 ===
 
<div class="hentry" id="hcard-vs-vcard-name">
{{OpenIssue}}
<span class="entry-summary author vcard">
<span class="published">2006-05-11</span>
[http://microformats.org/wiki/index.php?title=hcard-faq&diff=6324&oldid=6323 FAQ by <span class="fn">Brian Suda</span>], expanded/reraised by [[User:Tantek|Tantek]]
</span>
<div class="entry-content discussion issues">
* <strong class="entry-title">why does hCard use "vcard" as the root class or hCalendar use "vevent"?</strong>
** Originally partly [[hcard-faq#Why_does_hCard_use_vcard_as_the_root_class_name|an FAQ written by Brian Suda]], this slight inconsistency between the name of the format and the name of the root class name consistently causes confusion in a large percentage of newcomers to microformats. - [[User:Tantek|Tantek]]
*** Looks like a typo (just one letter difference)
*** Cognitive dissonance: saying "use hCard" but implying use "vcard" class name, or the implication causing one to just say "use vcard", e.g. [https://twitter.com/cssquirrel/status/129602573635289088 Kyle Weems]: <blockquote>I always end up saying "vcard" instead of "hcard" because I never write "hcard" in the code. It's weird having "two" formats that are 1:1.</blockquote>
*** Ambiguity in discussions, e.g. put "vcard" in your HTML - meaning, class name, or a link to a .vcf file?
*** Cognitive load: extra bit of information to remember when marking up a microformat
*** in contrast to [[hReview]], [[hListing]], [[hRecipe]], etc. which all have root class name same as name of microformat (albeit lowercased, however some publishers have used the 2nd-letter-uppercase version as the root class name, e.g. class="hReview", enough for Google's rich snippet parsers to liberally accept it, so those could be improved as well.).
** Though in microformats we believe very strongly in the [[principle]] of [[reuse]], we have to admit that in this case experience/evidence has shown that this may be a case where we re-used something too far beyond it's original meaning. Or perhaps we errantly called two slightly different things by the same name.  
*** '''ACCEPTED PROPOSED RESOLUTION.''' In [[microformats-2]], all vocabularies are named the same as their root class names, e.g. "h-card", "h-event", "h-entry" etc. - [[User:Tantek|Tantek]]
</div>
</div>
 
=== opened 2010 ===
Issues opened/raised in 2010.
 
<div class="hentry" id="class-collisions">
{{OpenIssue}}
<span class="entry-summary author vcard">
<span class="published">2010-08-24</span>
[http://html5doctor.com/microformats/#comment-10241 raised by <span class="fn">Wim</span>], expanded by [[User:Tantek|Tantek]]
</span>
<div class="entry-content discussion issues">
* <strong class="entry-title">microformats classes like 'url' or 'region' already in use</strong>. "Using class for the microformat markup is clearly a problem, in part because it’s so easy to overlap with other markup. Authors use classes like “url” or “region” all the time, and might not be aware of the hCard format. All sorts of markup might look like a microformat."
** There has also been an anecdotal report of a design firm who was not (yet) familiar with microformats seeing the "extra" classes that "that don't seem to be used" (without corresponding CSS rules) and asking if they "can remove them". By making microformats class names different from generic words, authors unfamiliar with microformats may at least notice such distinction and infer special functionality accordingly. - [[User:Tantek|Tantek]]
** ACCEPTED. Pretty sure this was raised before, in IRC/lists elsewhere, but this URL was the earliest one I could find to capture it. - [[User:Tantek|Tantek]]
** 2011-10-26 [https://twitter.com/richardtvaughan/status/129235473414631424 confirmed by Richard Vaughan]:
*** "... Microformats can screw with existing CSS rules. ..."
** [https://twitter.com/richardtvaughan/status/129236380873261057 and follow-up same day also]:
*** "microformats are the easiest as it's just CSS classes, but may be a pain to implement if those class names are already used."
** See also '''Beware of microformats/CSS naming collisions''' section in http://knol.google.com/k/google-rich-snippets-tips-and-tricks (no edit history, date unknown, found 2011-350)
** '''ACCEPTED. PROPOSED RESOLUTION.''' We are fixing this with [[microformats-2]], all property names have prefixes to avoid such collisions. E.g. 'url' becomes 'u-url' and 'region' becomes 'p-region'. See [[microformats-2#h-card|microformats 2: h-card properties]] for more. - [[User:Tantek|Tantek]]
</div>
</div>
 
=== opened 2011 ===
Issues opened/raised in 2011.


== Resolved Issues ==
Issues that are resolved but may have outstanding [[to-do]] items. As issues are resolved, they will be moved from the top of the [[microformats-issues#Issues|Issues list]] to the bottom of this section.
* ...
* ...


== Issues ==
=== Template ===
{{issues-format}}
 
=== Format Specific Issues ===
=== Format Specific Issues ===
 
Please raise format specific issues on their respective page(s):
Please raise format specific issues on the respective page:


* [[hatom-issues]]
* [[hatom-issues]]
* [[hcard-issues]]
* [[hcard-issues]]
** [[representative-hcard-issues]]
* [[hcalendar-issues]]
* [[hcalendar-issues]]
* [[hlisting-issues]]
* [[hresume-issues]]
* [[hreview-issues]]
* [[hreview-issues]]
* [[rel-issues]]
* [[rel-values-issues]]
* [[rel-license-issues]]
** [[rel-home-issues]]
** [[rel-license-issues]]
* [[vote-links-issues]]
* [[vote-links-issues]]
* [[xfn-issues]]
* [[xfn-issues]]
Line 36: Line 89:
* [[xmdp-issues]]
* [[xmdp-issues]]
* [[xoxo-issues]]
* [[xoxo-issues]]
* etc.
** [[xoxo-opml-issues]]
 
Issues regarding microformats in progress (brainstorms etc.) are documented on their respective pages.


=== Pattern Specific Issues ===
=== Pattern Specific Issues ===
Please raise pattern specific issues on the respective page:
Please raise pattern specific issues on the respective page:


*[[abbr-design-pattern-issues]]
*[[abbr-design-pattern-issues]]
** [[accessibility-issues#abbr-design-pattern]].
*[[include-pattern-issues]]
*[[include-pattern-issues]]
* etc.
* etc.


 
=== Domain Specific Issues ===
 
*[[accessibility-issues]]
=== IP Issues ===
*[[code-issues]]
* 2006-12-08 raised by [[User:AndyMabbett|Andy Mabbett]].
*# As evidenced in [http://microformats.org/discuss/mail/microformats-discuss/2006-December/007531.html discussion of an emailed response from eBay], the current position on the IP rights relating to microformats is unclear, or at least not clearly expressed. It seems to me that there should be an unambiguous statement of the current position, either for each individual format, or collectively, on a page to which people with concerns may be directed.
*#* ACCEPTED.  A clearer statement of both copyright and patents both in specific specs and in general would be a good thing. In general, the end result that our current copyright/patent statements seek is Creative Commons, W3C, and IETF compatibility in terms of both copyrights, and royalty free patent policies. I [[to-do#Tantek|will work]] on this [[User:Tantek|Tantek]] 11:58, 9 Dec 2006 (PST)
*#** {{OpenIssue}} This appears to be unresolved; and in the light of, for example, [[hCard#Copyright the hCard 'spec']], the statement in the FAQ that "[http://microformats.org/wiki/faq#Q:_Who_controls_microformats.3F Microformats are open standards licensed under Creative Commons Attribution]" to be, at best, erroneous and misleading. [[User:AndyMabbett|Andy Mabbett]] 11:04, 10 Mar 2007 (PST)
*#**Also [http://en.wikipedia.org/w/index.php?title=Wikipedia_talk:Attribution&curid=7391090&diff=117538680&oldid=117536621 causing concern here]. '''Prompt resolution would be advisable''' [[User:AndyMabbett|Andy Mabbett]] 09:04, 24 Mar 2007 (PDT)
*#*** First, [[citation]] is not ready for use in Wikipedia anyway.  Second, what is unclear about the Creative Commons/W3C/IETF license and patent statements?  This appears to be a theoretical issue / nitpick.  Yes, things can be made clearer, but "erroneous" and "misleading" are inaccurate labels.
*#*** This is not a citation issue. For example, [[hcard#Copyright|hCard's current copyright statement]] is not compatible with the Creative Commons license:<br><blockquote>{{MicroFormatCopyrightStatement2004}}</blockquote><br>If you look at the wikicode, this is actually the "MicroFormatCopyrightStatement2004" default microformat copyright.--[[User:JoeAndrieu|JoeAndrieu]] 15:09, 24 Mar 2007 (PDT)
 
* Further to the above (but out-dented for clarity), [[hresume|hResume]] cedes copyright to "the authors": "This specification is (C) 2006 by the authors"; and names just one author; Ryan King. What legal standing does the "the authors (sic) intend to submit..." clause have? What exists, to reassure someone (or some mega corporation's lawyers) contemplating or already using hResume that they won't be invoiced by Mr King? Why aren't the other people who contributed to that spec jointly credited with its copyright? [[User:AndyMabbett|Andy Mabbett]] 17:34, 24 Mar 2007 (PDT)
 
*Also, there appears to be nothing on [[buttons]] to say that they're freely licensed, or public-domain. [[User:AndyMabbett|Andy Mabbett]] 03:01, 25 Mar 2007 (PDT)
 
=== Legal Entity Issues ===
2007-03-24 raised by [[User:JoeAndrieu|Joe Andrieu]], clarified by [[User:Rohit|Rohit Khare]] on 2007-03-27.
# What is the legal entity responsible for operating microformats.org?
#* [[User:Rohit|Rohit Khare]] originally registered the microformats.com and .org domain names on 2005-01-25 and [http://commerce.net| CommerceNet, LLC], a non-profit 'think tank' with a long history as a neutral sponsor for developing standards for Internet commerce (often, in conjunction with other formal standards bodies). CommerceNet currently underwrites the server hosting costs and, in the past, has co-ordinated donations with other sponsors for events such as the [http://microformats.org/blog/2006/06/16/microformatsorg-anniversary-party/|first anniversary party], the [http://wiki.commerce.net/wiki/ZCommerceWS#Microformats workshop] where the site was launched, and promotional items.
# What is the legal entity responsible for the intellectual property on microformats.org? 
#* The current [[Template:MicroFormatCopyrightStatement|microformats copyright statement]] recognizes that IP is originally vested in the author(s), who are then expected to share those rights with the community by permitting their redistribution on microformats.org's wiki, blog, and mailing list archives. The additional distinction of becoming a specification may come with additional obligations to redistribute IP, such as a formal Creative Commons copyright license and a royalty-free patent license. The community is currently encouraging contibutors to [http://microformats.org/discuss/mail/microformats-discuss/2007-July/010221.html voluntarily adopt a public domain release].
#* Note that CommerceNet, LLC does ''not'' exercise any editorial control over the content of the site, mailing list, specifications, or the process, nor does it accept funds on behalf of microformats.org (see the [[Microformats:General_disclaimer|disclaimer]]). Conversely, the [[faq#Q:_Who_controls_microformats.3F|Admins]] do not have any independent legal identity at present, such as a partnership, foundation, or corporation. Please refer any legal questions or concerns directly to [mailto:rohit@khare.org Rohit Khare] before raising them as a matter of public record, as discussed on the mailing list [http://microformats.org/discuss/mail/microformats-discuss/2006-November/007086.html].
 
=== Governance Issues ===
:See: [[governance-issues]]
 
===Miscellaneous issues===
 
See also:
*[[external-issues]]
*[[external-issues]]
*[[accessibility-issues]]
*[[tests-issues]]
 
* {{OpenIssue}} 2006-10-17 raised by [[User:AndyMabbett|Andy Mabbett]] on [[wiki-feedback]]; moved here 2007-03-10.
*#  What is currently described as a "specification" on [[hCard]] and [[hCalendar]] is no such thing.
*#  Andy, what would it take to turn it into a "specification"?--[[User:JoeAndrieu|JoeAndrieu]] 15:13, 24 Mar 2007 (PDT)
 
=== New Issues ===
 
* {{OpenIssue}} 2007-04-01 raised by [[User:AndyMabbett|Andy Mabbett]].
*# Shouldn't microformats be recognised on <code>ID</code> as well as <code>class</code>? In other words, if I know I'm gong to have only one review or only one location, or whatever, on a page, then <code>"id=hReview"</code>, <code>id="geo"</code> etc. are semantically valid and appropriate. [[User:AndyMabbett|Andy Mabbett]] 11:32, 1 Apr 2007 (PDT)
 
* ...
 
== Template ==
 
Please use this format (copy and paste this to the end of the list to add your issues):
* {{OpenIssue}} YYYY-MM-DD raised by [http://yourhomepage.example.com YOURNAME].
*# ''Issue 1: Here is the first issue I have.''
*# ''Issue 2: Here is the second issue I have.''


==See also==
==See also==

Latest revision as of 16:28, 18 July 2020


These are externally raised issues about microformats in general.

Some issues may be ACCEPTED and perhaps cause changes or improved explanations in one or more specifications or microformats in general. Some issues may be REJECTED for a variety of brief reasons, and others contain longer discussions.

As this is a general microformats issues page, please only note concrete real world issues. Theoretical issues may be deleted, as will any issues raised that do not contain documentation of specific real-world examples that use real-world microformats (not just brainstorms).

Please be sure that an issue applies to more than one microformat or pattern, otherwise the issue should be raised on the format/pattern specific issues page. Please check issues-resolved and issues-closed to first see if your issue has a resolution.

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

Closed Issues

Resolved issues that have no further actions to take.

Resolved Issues

Resolved issues that have outstanding to-do items.

Issues

opened 2006

open issue! 2006-05-11 FAQ by Brian Suda, expanded/reraised by Tantek

  • why does hCard use "vcard" as the root class or hCalendar use "vevent"?
    • Originally partly an FAQ written by Brian Suda, this slight inconsistency between the name of the format and the name of the root class name consistently causes confusion in a large percentage of newcomers to microformats. - Tantek
      • Looks like a typo (just one letter difference)
      • Cognitive dissonance: saying "use hCard" but implying use "vcard" class name, or the implication causing one to just say "use vcard", e.g. Kyle Weems:

        I always end up saying "vcard" instead of "hcard" because I never write "hcard" in the code. It's weird having "two" formats that are 1:1.

      • Ambiguity in discussions, e.g. put "vcard" in your HTML - meaning, class name, or a link to a .vcf file?
      • Cognitive load: extra bit of information to remember when marking up a microformat
      • in contrast to hReview, hListing, hRecipe, etc. which all have root class name same as name of microformat (albeit lowercased, however some publishers have used the 2nd-letter-uppercase version as the root class name, e.g. class="hReview", enough for Google's rich snippet parsers to liberally accept it, so those could be improved as well.).
    • Though in microformats we believe very strongly in the principle of reuse, we have to admit that in this case experience/evidence has shown that this may be a case where we re-used something too far beyond it's original meaning. Or perhaps we errantly called two slightly different things by the same name.
      • ACCEPTED PROPOSED RESOLUTION. In microformats-2, all vocabularies are named the same as their root class names, e.g. "h-card", "h-event", "h-entry" etc. - Tantek

opened 2010

Issues opened/raised in 2010.

open issue! 2010-08-24 raised by Wim, expanded by Tantek

  • microformats classes like 'url' or 'region' already in use. "Using class for the microformat markup is clearly a problem, in part because it’s so easy to overlap with other markup. Authors use classes like “url” or “region” all the time, and might not be aware of the hCard format. All sorts of markup might look like a microformat."
    • There has also been an anecdotal report of a design firm who was not (yet) familiar with microformats seeing the "extra" classes that "that don't seem to be used" (without corresponding CSS rules) and asking if they "can remove them". By making microformats class names different from generic words, authors unfamiliar with microformats may at least notice such distinction and infer special functionality accordingly. - Tantek
    • ACCEPTED. Pretty sure this was raised before, in IRC/lists elsewhere, but this URL was the earliest one I could find to capture it. - Tantek
    • 2011-10-26 confirmed by Richard Vaughan:
      • "... Microformats can screw with existing CSS rules. ..."
    • and follow-up same day also:
      • "microformats are the easiest as it's just CSS classes, but may be a pain to implement if those class names are already used."
    • See also Beware of microformats/CSS naming collisions section in http://knol.google.com/k/google-rich-snippets-tips-and-tricks (no edit history, date unknown, found 2011-350)
    • ACCEPTED. PROPOSED RESOLUTION. We are fixing this with microformats-2, all property names have prefixes to avoid such collisions. E.g. 'url' becomes 'u-url' and 'region' becomes 'p-region'. See microformats 2: h-card properties for more. - Tantek

opened 2011

Issues opened/raised in 2011.

  • ...

Template

Consider using this format (copy and paste this to the end of the list to add your issues; replace ~~~ with an external link if preferred) to report issues or feedback, so that issues can show up in hAtom subscriptions of this issues page. If open issues lack this markup, please add it.

Please post one issue per entry, to make them easier to manage. Avoid combining multiple issues into single reports, as this can confuse or muddle feedback, and puts a burden of separating the discrete issues onto someone else who 1. may not have the time, and 2. may not understand the issue in the same way as the original reporter.

<div class="hentry">
{{OpenIssue}} 
<span class="entry-summary author vcard">
 <span class="published">2011-MM-DD</span> 
 raised by <span class="fn">~~~</span>
</span>
<div class="entry-content discussion issues">
* <strong class="entry-title">«Short title of issue»</strong>. «Description of Issue»
** Follow-up comment #1
** Follow-up comment #2
</div>
</div>

Format Specific Issues

Please raise format specific issues on their respective page(s):

Issues regarding microformats in progress (brainstorms etc.) are documented on their respective pages.

Pattern Specific Issues

Please raise pattern specific issues on the respective page:

Domain Specific Issues

See also