21438 2013-03-29 20:50:02 +0000 Relocate the informative NOTE on authoring Best Practices to where it is relevant. 2013-04-10 03:46:10 +0000 1 1 1 Unclassified HTML WG HTML Image Description Extension unspecified PC All CLOSED FIXED http://www.w3.org/TR/2013/WD-html-longdesc-20130312/#longdesc a11y, a11y_text-alt P2 normal --- 1 xn--mlform-iua chaals hans.hillen public-html-admin xn--mlform-iua public-html-bugzilla oldest_to_newest 85161 0 xn--mlform-iua 2013-03-29 20:50:02 +0000 The following NOTE section does currently occur after 4 pargraphs about how User Agents SHOULD or MAY handle the longdesc attribute: ]] Best practices for full descriptions of images are beyond the scope of this document, but there are many resources available.[[ Please, instead, move the above NOTE so that it occurs ommediately after the following paragraph: ]] Authors should put descriptions within an element which is the target of a fragment link (e.g. longdesc="example.html#description") if a description is only part of the target document. [[ Justification: * The cited NOTE section relates to authoring and should thus occur directly after the normative information on authoring. * It is particulary offputting that the cited NOTE section currently occurs directly after a paragraphs about how User Agents MAY treat invalid longdesc attributes. With the wrong glasses on, this could give the impression that is OK for authors to fill the content of @longdesec with textual content (rather than a URL). 85253 1 chaals 2013-04-01 14:26:37 +0000 Hmm. THe conflict here is whether to put the limited best practice notes into a group, or group them by audience (authors, user agents, ...) I'm happy to change the grouping to make it more audience specific. I'll try to do that for the next editors' draft which I hope to publish tomorrow. 85259 2 xn--mlform-iua 2013-04-01 15:54:36 +0000 (In reply to comment #1) > I'm happy to change the grouping to make it more audience specific. I'll try > to do that for the next editors' draft which I hope to publish tomorrow. Super! 85488 3 chaals 2013-04-03 12:32:55 +0000 This has been done as of https://dvcs.w3.org/hg/html-proposals/raw-file/0dd2e510d4e1/longdesc1/longdesc.html