adding a note to 4.3.10.1 Creating an outline

Section 4.3.10.1 Creating an outline [1] defines an outlining algorithm,
but there are no implementation requirements for user agents.
Authors/developers have been lead to believe that the algorithm is
something real that is implemented by user agents, this has lead to the
dissemination of incorrect authoring advice in books, on the web etc.

I propose to add a note at the start of section 4.3.10.1 to clarify,
something along the lines of:

"the implementation of the outline algorithm in user agents is not
required, Its inclusion in the specification is for informative purposes
only. "

any thoughts?

[1] http://www.w3.org/html/wg/drafts/html/master/sections.html#outlines
--

Regards

SteveF
HTML 5.1 <http://www.w3.org/html/wg/drafts/html/master/>

Received on Tuesday, 25 February 2014 15:50:28 UTC