haudio-issues: Difference between revisions

From Microformats Wiki
Jump to navigation Jump to search
m (oops typo)
m (Reverted edits by I MADE THOUSANDS OF ACCOUNTS IN MICROFORMATS WIKI GO TO CHECK OUT THE USER LIST ([[User talk:I MADE THOUSANDS OF ACCOUNTS IN MICROF)
 
(84 intermediate revisions by 11 users not shown)
Line 8: Line 8:
<span id="Issues">Please add new issues</span> to the '''bottom''' of the list by copy and pasting the [[haudio-issues#Template|Template]]. Please follow-up to resolved/rejected issues with new information rather than resubmitting such issues. Duplicate issue additions will be reverted.
<span id="Issues">Please add new issues</span> to the '''bottom''' of the list by copy and pasting the [[haudio-issues#Template|Template]]. Please follow-up to resolved/rejected issues with new information rather than resubmitting such issues. Duplicate issue additions will be reverted.


===2008===
==2008==


=== D1: 2008-01-10  Contributor ===
<div class="vevent">
<div class="vevent">
* {{OpenIssue}} D1: <span class="summary vcard"><span class="dtstart">2008-01-10</span> raised by <span class="fn">[[User:AndyMabbett|Andy Mabbett]]</span> in [http://microformats.org/discuss/mail/microformats-discuss/2008-January/011340.html microformats-discuss/2008-January/011340.html]</span>
* {{ResolvedIssue}} D1: <span class="summary vcard"><span class="dtstart">2008-01-10</span> raised by <span class="fn">[[User:AndyMabbett|Andy Mabbett]]</span> in [http://microformats.org/discuss/mail/microformats-discuss/2008-January/011340.html microformats-discuss/2008-January/011340.html]</span>
<div class="description">
<div class="description">
*# the wording about <code>contributor</code> could be improved to facilitate more streamlined mark-up (see above e-mail for details).
*# the wording about <code>contributor</code> could be improved to facilitate more streamlined mark-up (see above e-mail for details).
*#* A resolution to this issue is outlined in this email http://microformats.org/discuss/mail/microformats-new/2008-August/001725.html
*#* ACCEPTED ISSUE The hAudio Contributor Specification is to be changed to:
*#** The element is identified by the class name |contributor|.
*#** hAudio /MAY/ include one or more contributors.
*#** The contributor's name SHOULD also be marked up as a valid hCard Microformat. <http://microformats.org/wiki/hcard>
*#**# The |role| attribute /SHOULD/ be used to specify the contributor's responsibility related to the audio recording if hCard is utilized.
*#** The contributor's name MAY be specified in plain-text without being enclosed in a hCard Microformat.
*#* REMOVED:
*#** If multiple contributors are specified, without |role| specifications, it /MAY/ be assumed that the first role mentioned is the primary artist or creator.
*#**# As proposed By [[User:ManuSporny|Manu Sporny]] in http://microformats.org/discuss/mail/microformats-new/2008-August/001725.html
</div>
</div>
</div>
</div>
=== D2: 2008-01-10 hAudio Title was Overloading "fn".===


<div class="vevent">
<div class="vevent">
* {{OpenIssue}} D2: <span class="summary vcard"><span class="dtstart">2008-01-10</span> raised by <span class="fn">[[User:AndyMabbett|Andy Mabbett]]</span> in [http://microformats.org/discuss/mail/microformats-discuss/2008-January/011342.html] </span>
* {{ResolvedIssue}} D2: <span class="summary vcard"><span class="dtstart">2008-01-10</span> raised by <span class="fn">[[User:AndyMabbett|Andy Mabbett]]</span> in [http://microformats.org/discuss/mail/microformats-discuss/2008-January/011342.html] </span>
<div class="description">
<div class="description">
*# The "overloading" of <code>fn</code> for both the tile of a work and the name of a contributor causes problems (see above e-mail for examples). Another example of this problem is a table, where the "artist" column comes before the "title" column. For discussion, see also [http://microformats.org/discuss/mail/microformats-new/2008-January/001375.html microformats-new/2008-January/001375.html].
The "overloading" of <code>fn</code> for both the tile of a work and the name of a contributor causes problems (see above e-mail for examples). Another example of this problem is a table, where the "artist" column comes before the "title" column. For discussion, see also [http://microformats.org/discuss/mail/microformats-new/2008-January/001375.html microformats-new/2008-January/001375.html].
*#*[[User:ManuSporny|Manu Sporny]] has propsosed that <code>"fn"</code> should be replaced with <code>"title"</code> see: [http://microformats.org/discuss/mail/microformats-new/2008-February/001468.html microformats-new/2008-February/001468.html]
# Existing Resolution [[User:ManuSporny|Manu Sporny]] has propsosed that <code>"fn"</code> should be replaced with <code>"title"</code> see: [http://microformats.org/discuss/mail/microformats-new/2008-February/001468.html microformats-new/2008-February/001468.html]
*#* [[User:WebOrganics|Martin McEvoy]] later propsosed that <code>"title"</code> should be replaced with <code>"htitle"</code> see: [http://microformats.org/discuss/mail/microformats-new/2008-August/001692.html microformats-new/2008-August/001692.html]
#* +1 [[User:ManuSporny|Manu Sporny]] (first choice)
#* +1 [[User:ManuSporny|Sarven Capadisli]] (second choice)
# Resolution 1: [[User:WebOrganics|Martin McEvoy]] proposed change <code>"title"</code> to <code>"name"</code> see: [http://microformats.org/discuss/mail/microformats-new/2008-March/001555.html microformats-new/2008-March/001555.html]
# Resolution 2: [[User:WebOrganics|Martin McEvoy]] later propsosed that <code>"title"</code> should be replaced with <code>"htitle"</code> see: [http://microformats.org/discuss/mail/microformats-new/2008-August/001692.html microformats-new/2008-August/001692.html]
#* +1 [[User:ManuSporny|Manu Sporny]] (second choice)
#* +1 [[User:Csarven|Sarven Capadisli]] (first choice)
# Resolution 3: Use <code>"audio-title"</code> As tentatively proposed by [[User:ManuSporny|Manu Sporny]] see:[http://microformats.org/discuss/mail/microformats-new/2008-August/001692.html microformats-new/2008-August/001692.html]
# Resolution 4: Change <code>"title"</code> back to <code>"fn"</code> see: [http://microformats.org/wiki?title=haudio&diff=prev&oldid=25667]
#* +1 [[User:WebOrganics|Martin McEvoy]] Without Reservations see:[http://microformats.org/wiki?title=haudio-issues&diff=0&oldid=28703 haudio-issues&diff=0&oldid=28703]
#* +1 [[User:ManuSporny|Manu Sporny]] (third choice)
#* +1 [[User:DavidJanes]] this is the correct thing to do
#* +1 [[User:Csarven|Sarven Capadisli]] (third choice)
# Don't really care — just pick one. ;-)
#* +1 [[User:TobyInk|TobyInk]]
#* +1 [[User:ManuSporny|Manu Sporny]] - close this damn discussion, already! :)
* ACCEPTED ISSUE, RESOLUTION: Change <code>"title"</code> back to <code>"fn"</code> see: [http://microformats.org/discuss/mail/microformats-new/2008-September/001797.html microformats-new/2008-September/001797.html]
</div>
</div>
</div>
</div>


=== D3: 2008-01-10 Position. ===
<div class="vevent">
<div class="vevent">
* {{OpenIssue}} D3: <span class="summary vcard"><span class="dtstart">2008-01-10</span> raised by <span class="fn">[[User:AndyMabbett|Andy Mabbett]]</span> in [http://microformats.org/discuss/mail/microformats-discuss/2008-January/011343.html microformats-discuss/2008-January/011343.html]</span>
* {{ResolvedIssue}} D3: <span class="summary vcard"><span class="dtstart">2008-01-10</span> raised by <span class="fn">[[User:AndyMabbett|Andy Mabbett]]</span> in [http://microformats.org/discuss/mail/microformats-discuss/2008-January/011343.html microformats-discuss/2008-January/011343.html]</span>
<div class="description">
<div class="description">
*# The [http://microformats.org/wiki/haudio#Complete_Album_Example recommended use of "position" in hAudio] is contrary to the good practice, semantic use of ordered lists (see example and suggested solution in the above e-mail; also [http://microformats.org/discuss/mail/microformats-new/2008-January/001338.html] et seq)
*# The [http://microformats.org/wiki/haudio#Complete_Album_Example recommended use of "position" in hAudio] is contrary to the good practice, semantic use of ordered lists (see example and suggested solution in the above e-mail; also [http://microformats.org/discuss/mail/microformats-new/2008-January/001338.html] et seq)
*#* For Cognition I'm considering an extension: if no position has been explicitly marked up, and the item is <code>&lt;li class="item"></code> within an ordered list, then the position is taken to be the numerical value of the list marker. (To calculate the numerical value for the list marker, find the most recent sibling <code>&lt;li></code> element which has a <code>value</code> attribute. The numerical value is the number in that value attribute added to the count of <code>&lt;li></code> elements after that value attribute up to the current one. If there are no such <code>&lt;li></code> elements with <code>value</code> attributes, then you should assume that the <code>value</code> attribute of the first list item is equal to the <code>start</code> attribute of the ordered list itself, or "1" if there is no such <code>start</code> attribute. [[User:TobyInk|TobyInk]] 04:24, 29 Jul 2008 (PDT)
*#* For Cognition I'm considering an extension: if no position has been explicitly marked up, and the item is <code>&lt;li class="item"></code> within an ordered list, then the position is taken to be the numerical value of the list marker. (To calculate the numerical value for the list marker, find the most recent sibling <code>&lt;li></code> element which has a <code>value</code> attribute. The numerical value is the number in that value attribute added to the count of <code>&lt;li></code> elements after that value attribute up to the current one. If there are no such <code>&lt;li></code> elements with <code>value</code> attributes, then you should assume that the <code>value</code> attribute of the first list item is equal to the <code>start</code> attribute of the ordered list itself, or "1" if there is no such <code>start</code> attribute. [[User:TobyInk|TobyInk]] 04:24, 29 Jul 2008 (PDT)
*#* Martin McEvoy has recommended that this issue be marked as Closed as it was resolved in this email: ( http://microformats.org/discuss/mail/microformats-discuss/2008-January/011353.html)
*#* A Proposed Resolution was made in this email: ( http://microformats.org/discuss/mail/microformats-new/2008-August/001751.html)
*#* ACCEPTED ISSUE The hAudio Position Specification is to be changed to:
*#** The element is identified by the class name |position|.
*#** hAudio /MAY/ include one |position| element.
*#** The contents of the element /MUST/ be a number or other sequential identifier.
*#** The sequential identifier /MAY/ be specified out-of-sequence.
*#* ADDED:
*#** The sequential identifier /MAY/ be specified out-of-sequence.
*#**# As proposed By [[User:ManuSporny|Manu Sporny]] in  http://microformats.org/discuss/mail/microformats-new/2008-August/001708.html  
*#* [[User:AndyMabbett|Andy Mabbett]] also Expressed concerns that the [[haudio#Complete_Album_Example|Complete Album Example]] should be marked up as an ordered list this is unnecessary as <code>"position"</code> is not related to the order of a track item in a list.
*#* A tutorial on the correct use of semantic ordered lists and hAudio is to be added to the [[haudio-authoring|hAudio Authoring]] Page
</div>
</div>
</div>
</div>


=== D4: 2008-01-10  rel-enclosure does not allow for links to streaming files ===
<div class="vevent">
<div class="vevent">
* {{OpenIssue}} D4: <span class="summary vcard"><span class="dtstart">2008-01-10</span> raised by <span class="fn">[[User:AndyMabbett|Andy Mabbett]]</span> in [http://microformats.org/discuss/mail/microformats-discuss/2008-January/011344.html microformats-discuss/2008-January/011344.html]</span>
* {{OpenIssue}} D4: <span class="summary vcard"><span class="dtstart">2008-01-10</span> raised by <span class="fn">[[User:AndyMabbett|Andy Mabbett]]</span> in [http://microformats.org/discuss/mail/microformats-discuss/2008-January/011344.html microformats-discuss/2008-January/011344.html]</span>
<div class="description">
<div class="description">
*# The required use of [[rel-enclosure]] does not allow for links to streaming files, which are not cacheable, and are thus outside the scope of rel-enclosure. [http://www.bbc.co.uk/radio4/science/livingworld_20041121.shtml An example on the BBC website] has the relevant link is below the heading "LISTEN AGAIN". (see discussion at [http://microformats.org/discuss/mail/microformats-new/2008-January/001339.html microformats-new/2008-January/001339.html] et seq).
*# The required use of [[rel-enclosure]] does not allow for links to streaming files, which are not cacheable, and are thus outside the scope of rel-enclosure. [http://www.bbc.co.uk/radio4/science/livingworld_20041121.shtml An example on the BBC website] has the relevant link is below the heading "LISTEN AGAIN". (see discussion at [http://microformats.org/discuss/mail/microformats-new/2008-January/001339.html microformats-new/2008-January/001339.html] et seq).
*#* A proposal for this issue was first made in this email http://microformats.org/discuss/mail/microformats-new/2008-August/001715.html
*#* A second proposal for this issue has been made in this email http://microformats.org/discuss/mail/microformats-new/2008-August/001727.html
*#* This can potentially be solved by recognition of downloadable/streamable MIME types. For performance reasons it is undesirable for parsers to be required to make HTTP requests for each file to determine its MIME type, so authors should be encouraged to include the MIME type in the <code>type</code> attribute. See the [[haudio-brainstorming#Download_links|related section on "brainstorming"]]. [[User:TobyInk|TobyInk]] 14:41, 20 Aug 2008 (PDT)
*#* ACCEPTED ISSUE The hAudio Enclosure Specification is to be changed to:
*#** The element is identified by a URI fitting the rel-design-pattern, the rel content being enclosure.
*#** hAudio MAY include one or more enclosure URIs.
*#** The type of the file SHOULD be specified by using the type specifier for a URI.
*#* CHANGED:
*#** The type of the file MAY be specified by using the type specifier for a URI.
*#*** As suggested by [[User:Tantek|Tantek Çelik]] in this email http://microformats.org/discuss/mail/microformats-new/2008-August/001731.html
*#*** As Proposed by [[User:TobyInk|Toby Inkster]] on 14:41, 20 Aug 2008 (PDT)
*#* A tutorial on the importance of Type Specifiers and hAudio Enclosures is to be added to the [[haudio-authoring|hAudio Authoring]] Page
*#* BLOCKED: The [[rel-enclosure]] definition needs to be updated in order to allow specification of links to streaming files.
</div>
</div>
</div>
</div>


=== D5: 2008-01-10  there is no way of linking to an interim page ===
<div class="vevent">
<div class="vevent">
* {{OpenIssue}} D5: <span class="summary vcard"><span class="dtstart">2008-01-10</span> raised by <span class="fn">[[User:AndyMabbett|Andy Mabbett]]</span> in [http://microformats.org/discuss/mail/microformats-discuss/2008-January/011344.html microformats-discuss/2008-January/011344.html]</span>
* {{OpenIssue}} D5: <span class="summary vcard"><span class="dtstart">2008-01-10</span> raised by <span class="fn">[[User:AndyMabbett|Andy Mabbett]]</span> in [http://microformats.org/discuss/mail/microformats-discuss/2008-January/011344.html microformats-discuss/2008-January/011344.html]</span>
<div class="description">
<div class="description">
*# There appears to be no mechanism to mark up an hAudio, expressed in plain text on page A, which links to an interim page, B, which in turn links to a file download. For example, the radio shows listed on [http://www.westmidlandbirdclub.com/bibliography/radio].
There appears to be no mechanism to mark up an hAudio, expressed in plain text on page A, which links to an interim page, B, which in turn links to a file download. For example, the radio shows listed on [http://www.westmidlandbirdclub.com/bibliography/radio].
</div>
</div>
# Resolution 1: re use <code>"url"</code> from [[hcard|hCard]].
#* +1 [[User:WebOrganics|Martin McEvoy]] all links are not clickable/hyperlinkable.
#* +1 [[User:TobyInk|TobyInk]]
# Resolution 2: use the rel <code>"bookmark"</code> [http://www.w3.org/TR/REC-html40/types.html#type-links HTML Link Type].
</div>
</div>


=== D6: 2008-01-10 hAudio notes inconsistency ===
<div class="vevent">
<div class="vevent">
* {{ResolvedIssue}} D6: <span class="summary vcard"><span class="dtstart">2008-01-10</span> raised by <span class="fn">[[User:AndyMabbett|Andy Mabbett]]</span> in [http://microformats.org/discuss/mail/microformats-discuss/2008-January/011345.html microformats-discuss/2008-January/011345.html]</span>
* {{ResolvedIssue}} D6: <span class="summary vcard"><span class="dtstart">2008-01-10</span> raised by <span class="fn">[[User:AndyMabbett|Andy Mabbett]]</span> in [http://microformats.org/discuss/mail/microformats-discuss/2008-January/011345.html microformats-discuss/2008-January/011345.html]</span>
Line 54: Line 113:
*# [[haudio#Notes|The "Notes" section of the hAudio spec]] says "By marking up audio content with the hAudio microformat, the expectation is communicated that information about the content {{may}} be indexed. This has no impact on the copyright of the content itself which the publisher may explicitly specify using rel-license as specified above.". However, that is the first and only reference to [[rel-license]] on the page.
*# [[haudio#Notes|The "Notes" section of the hAudio spec]] says "By marking up audio content with the hAudio microformat, the expectation is communicated that information about the content {{may}} be indexed. This has no impact on the copyright of the content itself which the publisher may explicitly specify using rel-license as specified above.". However, that is the first and only reference to [[rel-license]] on the page.
*#* Typing error changed to "By marking up audio content with the hAudio microformat, the expectation is communicated that information about the content MAY be indexed. This has no impact on the copyright of the content itself which the publisher may explicitly specify using the rel-license microformat". [http://microformats.org/wiki?title=haudio&diff=0&oldid=27951]
*#* Typing error changed to "By marking up audio content with the hAudio microformat, the expectation is communicated that information about the content MAY be indexed. This has no impact on the copyright of the content itself which the publisher may explicitly specify using the rel-license microformat". [http://microformats.org/wiki?title=haudio&diff=0&oldid=27951]
*#* hAudio Specification SHOULD include the [[rel-license]] microformat [[User:WebOrganics|Martin McEvoy]] 11:57, 18 Aug 2008 (GMT)
*#* A proposed resolution to this issue has been made in this email http://microformats.org/discuss/mail/microformats-new/2008-August/001720.html
*# RESOLVED <code>rel="licence"</code> is not part of this version of hAudio (0.9) see:http://microformats.org/discuss/mail/microformats-new/2008-August/001747.html
</div>
</div>
==2009==
=== D7: 2009-01-11  Endorsement of optimization patterns in schema listing too strong ===
<div class="vevent">
* {{ResolvedIssue}} D7: <span class="summary vcard"><span class="dtstart">2009-01-11</span> raised by <span class="fn">[[User:BenWard|Ben Ward]]</span>.</span>
<p class="description">The hAudio spec schema makes references to multiple optimization patterns (datetime pattern for <code>published</code>, abbr-pattern for <code>duration</code>). It is currently worded as to imply that those patterns ''must'' be used. Given past disagreement over ABBR in particular, I think the spec should avoid specific endorsement of any pattern, at the very least reducing references to patterns to clear ‘You ''may'' use the abbr-pattern with this field' sort of phrasing.</p>
# Resolution 1: Reword schema listing to use ''may'' language clearly.
#* +1 [[User:BenWard|Ben Ward]]
#* +1 [[User:TobyInk|TobyInk]]
#* +1 [[User:WebOrganics|Martin McEvoy]]
** RESOLUTION: The schema now uses ''may'' language more clearly
</div>
=== D8: 2009-01-11  Don't link to currency proposal ===
<div class="vevent">
* {{ResolvedIssue}} D8: <span class="summary vcard"><span class="dtstart">2009-01-11</span> raised by <span class="fn">[[User:BenWard|Ben Ward]]</span>.</span>
<p class="description">The hAudio spec schema makes reference to the currency proposal. Since that is still a proposal, the spec should not endorse it or encourage too-early adoption of it, especially since it's not even a ''draft'' at this stage. Should the currency work be completed, hAudio should be updated later, rather than linking it in pre-emptively.</p>
# Resolution 1: Remove reference to currency proposal from hAudio schema.
#* +1 [[User:BenWard|Ben Ward]]
#* +1 [[User:TobyInk|TobyInk]]
#* +1 [[User:WebOrganics|Martin McEvoy]]
** RESOLUTION: The hAudio no longer references the currency proposal, only cites it as an Informative reference at the bottom of the page.
</div>
==2010==
=== D9: 2010-06-11  hAudio duration and published should adopt the value-title pattern ===
<div class="vevent">
* {{OpenIssue}} D9: <span class="summary vcard"><span class="dtstart">2010-06-11</span> raised by <span class="fn">[[User:WebOrganics|Martin McEvoy]]</span>.</span>
<p class="description">[[haudio#Duration|hAudio Duration]] and [[haudio#Published|Published]] should adopt the value-title pattern like [[hrecipe#duration|hRecipe Duration]] and [[hatom-profile|hAtom]], to prevent the user from getting machine data in a tooltip.</p>
Example:
<pre><span class="duration">
  3 minutes 33 seconds
  <span class="value-title" title="PT3M33S">.</span>
</span></pre>
and....
<pre><span class="published">
  February 06, 2007
  <span class="value-title" title="2007-02-06">.</span>
</span></pre>
# Resolution 1: Adopt the value-title pattern for both hAudio Duration and Published.
#* +1 [[User:WebOrganics|Martin McEvoy]]
#* +1 [[User:AndyMabbett|Andy Mabbett]] via: [http://twitter.com/pigsonthewing/statuses/15935702988 Twitter]
</div>
==2012==
=== D10: 2012-02-13  hAudio sample and enclosure should support HTML5 audio ===
<div class="hentry">
* {{OpenIssue}} D10: <span class="entry-summary author vcard"><span class="published">2012-02-13</span> raised by <span class="fn">[[User:Panzi|Mathias Panzenböck]]</span>.</span>
<p class="description">[[haudio#Sample|hAudio Sample]] and [[haudio#Full_Download_.28Enclosure.29|hAudio Enclosure]] currently only support links to the audio files. Using the HTML5 audio tag it would be possible to embed the audio file directly in the page. The "sample" and "enclosure" markup would then be used as classes of the audio element.</p>
Example:
<pre><audio class="sample" src="sample.mp3" controls/></pre>
Or when specifying a fallback list of audio files:
<pre><audio class="enclosure" controls>
  <source type="audio/ogg" src="song.ogg"/>
  <source type="audio/mp4" src="song.m4a"/>
  <source type="audio/mpeg" src="song.mp3"/>
</audio></pre>
# Resolution 1: Support "sample" and "enclosure" as classes of HTML5 audio elements.
#* +1 [[User:Panzi|Mathias Panzenböck]]
</div>
</div>
=== D11: 2012-04-30  Add start time field ===
<div class="hentry">
* {{OpenIssue}} <span class="entry-summary author vcard"><span class="published">2012-04-30</span> raised by <span class="fn">[[User:James Fryer|James Fryer]]</span></span>
<p class="description">In our application we are using hAudio to represent tracks within an hour-long radio show. Although
the duration field is useful, we'd also like a start-time field. This would handle situations where there
is speech between tracks, so the actual duration of the track does not correspond to the time when the next track begins.
</p>
</div>
</div>



Latest revision as of 11:24, 22 September 2013

hAudio issues

These are externally raised issues about hAudio 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.

issues

Please add new issues to the bottom of the list by copy and pasting the Template. Please follow-up to resolved/rejected issues with new information rather than resubmitting such issues. Duplicate issue additions will be reverted.

2008

D1: 2008-01-10 Contributor

    1. the wording about contributor could be improved to facilitate more streamlined mark-up (see above e-mail for details).

D2: 2008-01-10 hAudio Title was Overloading "fn".

The "overloading" of fn for both the tile of a work and the name of a contributor causes problems (see above e-mail for examples). Another example of this problem is a table, where the "artist" column comes before the "title" column. For discussion, see also microformats-new/2008-January/001375.html.

  1. Existing Resolution Manu Sporny has propsosed that "fn" should be replaced with "title" see: microformats-new/2008-February/001468.html
  2. Resolution 1: Martin McEvoy proposed change "title" to "name" see: microformats-new/2008-March/001555.html
  3. Resolution 2: Martin McEvoy later propsosed that "title" should be replaced with "htitle" see: microformats-new/2008-August/001692.html
  4. Resolution 3: Use "audio-title" As tentatively proposed by Manu Sporny see:microformats-new/2008-August/001692.html
  5. Resolution 4: Change "title" back to "fn" see: [2]
  6. Don't really care — just pick one. ;-)

D3: 2008-01-10 Position.

    1. The recommended use of "position" in hAudio is contrary to the good practice, semantic use of ordered lists (see example and suggested solution in the above e-mail; also [3] et seq)
      • For Cognition I'm considering an extension: if no position has been explicitly marked up, and the item is <li class="item"> within an ordered list, then the position is taken to be the numerical value of the list marker. (To calculate the numerical value for the list marker, find the most recent sibling <li> element which has a value attribute. The numerical value is the number in that value attribute added to the count of <li> elements after that value attribute up to the current one. If there are no such <li> elements with value attributes, then you should assume that the value attribute of the first list item is equal to the start attribute of the ordered list itself, or "1" if there is no such start attribute. TobyInk 04:24, 29 Jul 2008 (PDT)
      • A Proposed Resolution was made in this email: ( http://microformats.org/discuss/mail/microformats-new/2008-August/001751.html)
      • ACCEPTED ISSUE The hAudio Position Specification is to be changed to:
        • The element is identified by the class name |position|.
        • hAudio /MAY/ include one |position| element.
        • The contents of the element /MUST/ be a number or other sequential identifier.
        • The sequential identifier /MAY/ be specified out-of-sequence.
      • ADDED:
      • Andy Mabbett also Expressed concerns that the Complete Album Example should be marked up as an ordered list this is unnecessary as "position" is not related to the order of a track item in a list.
      • A tutorial on the correct use of semantic ordered lists and hAudio is to be added to the hAudio Authoring Page

D4: 2008-01-10 rel-enclosure does not allow for links to streaming files

D5: 2008-01-10 there is no way of linking to an interim page

There appears to be no mechanism to mark up an hAudio, expressed in plain text on page A, which links to an interim page, B, which in turn links to a file download. For example, the radio shows listed on [4].

  1. Resolution 1: re use "url" from hCard.
  2. Resolution 2: use the rel "bookmark" HTML Link Type.

D6: 2008-01-10 hAudio notes inconsistency

2009

D7: 2009-01-11 Endorsement of optimization patterns in schema listing too strong

  • resolved issue D7: 2009-01-11 raised by Ben Ward.

The hAudio spec schema makes references to multiple optimization patterns (datetime pattern for published, abbr-pattern for duration). It is currently worded as to imply that those patterns must be used. Given past disagreement over ABBR in particular, I think the spec should avoid specific endorsement of any pattern, at the very least reducing references to patterns to clear ‘You may use the abbr-pattern with this field' sort of phrasing.

  1. Resolution 1: Reword schema listing to use may language clearly.
    • RESOLUTION: The schema now uses may language more clearly

D8: 2009-01-11 Don't link to currency proposal

  • resolved issue D8: 2009-01-11 raised by Ben Ward.

The hAudio spec schema makes reference to the currency proposal. Since that is still a proposal, the spec should not endorse it or encourage too-early adoption of it, especially since it's not even a draft at this stage. Should the currency work be completed, hAudio should be updated later, rather than linking it in pre-emptively.

  1. Resolution 1: Remove reference to currency proposal from hAudio schema.
    • RESOLUTION: The hAudio no longer references the currency proposal, only cites it as an Informative reference at the bottom of the page.

2010

D9: 2010-06-11 hAudio duration and published should adopt the value-title pattern

hAudio Duration and Published should adopt the value-title pattern like hRecipe Duration and hAtom, to prevent the user from getting machine data in a tooltip.

Example:

<span class="duration">
  3 minutes 33 seconds
  <span class="value-title" title="PT3M33S">.</span>
</span>

and....

<span class="published">
  February 06, 2007
  <span class="value-title" title="2007-02-06">.</span>
</span>
  1. Resolution 1: Adopt the value-title pattern for both hAudio Duration and Published.

2012

D10: 2012-02-13 hAudio sample and enclosure should support HTML5 audio

hAudio Sample and hAudio Enclosure currently only support links to the audio files. Using the HTML5 audio tag it would be possible to embed the audio file directly in the page. The "sample" and "enclosure" markup would then be used as classes of the audio element.

Example:

<audio class="sample" src="sample.mp3" controls/>

Or when specifying a fallback list of audio files:

<audio class="enclosure" controls>
  <source type="audio/ogg" src="song.ogg"/>
  <source type="audio/mp4" src="song.m4a"/>
  <source type="audio/mpeg" src="song.mp3"/>
</audio>
  1. Resolution 1: Support "sample" and "enclosure" as classes of HTML5 audio elements.

D11: 2012-04-30 Add start time field

In our application we are using hAudio to represent tracks within an hour-long radio show. Although the duration field is useful, we'd also like a start-time field. This would handle situations where there is speech between tracks, so the actual duration of the track does not correspond to the time when the next track begins.

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>

see also

related pages