[Bug 21438] New: Relocate the informative NOTE on authoring Best Practices to where it is relevant.

https://www.w3.org/Bugs/Public/show_bug.cgi?id=21438

            Bug ID: 21438
           Summary: Relocate the informative NOTE on authoring Best
                    Practices to where it is relevant.
    Classification: Unclassified
           Product: HTML WG
           Version: unspecified
          Hardware: PC
               URL: http://www.w3.org/TR/2013/WD-html-longdesc-20130312/#l
                    ongdesc
                OS: All
            Status: NEW
          Severity: normal
          Priority: P2
         Component: HTML Image Description Extension
          Assignee: chaals@yandex-team.ru
          Reporter: xn--mlform-iua@xn--mlform-iua.no
        QA Contact: public-html-bugzilla@w3.org
                CC: public-html-admin@w3.org,
                    xn--mlform-iua@xn--mlform-iua.no

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).

-- 
You are receiving this mail because:
You are the QA Contact for the bug.

Received on Friday, 29 March 2013 20:50:05 UTC