Re: HTML5: The Markup Language - section 5 suggestions

"Dr. Olaf Hoffmann" <Dr.O.Hoffmann@gmx.de>, 2010-03-02 12:23 +0100:

> An alphabetical order of element names is mainly useful for
> those authors, who are already familiar with the language or
> the language version to find some details, but not a big help 
> for those, who are trying to markup a specific structure and
> looking for proper elements for it. 
> Therefore if http://dev.w3.org/html5/spec-author-view/
> is intended for authors and 
> http://dev.w3.org/html5/html-author/ with a similar
> structure, what is the purpose of http://dev.w3.org/html5/markup/ ?

It's intended to describe what a "conforming document" of the HTML
language is.

> Mainly only a look-up table?

If you mean "a look-up table" in the sense of "a reference", then,
yeah, I think it has some use as a reference guide as well.

> But how does this fit to the abstract:
> '
> This document describes the HTML markup language and provides details 
> necessary for producers of HTML content to create documents that conform to 
> the language. By design, it does not define related APIs nor attempt to 
> specify how consumers of HTML content are meant to process documents.
> '
> ?
> For a look-up table the abstract should indicate, that it is mainly such 
> a look-up table for authors, who already know how to create documents
> in this HTML variant and are searching just for details, but not for a
> general idea.

I had mention of that already in the Introduction:

  http://dev.w3.org/html5/markup/intro.html#intro

See this part:

  Certain purposes are intentionally out of scope for this
  specification; in particular, it:
  ...
  does not attempt to be a tutorial or “how to” authoring guide

I've now also added that language to the end of the Abstract:

  http://dev.w3.org/html5/markup/#abstract

  --Mike

-- 
Michael(tm) Smith
http://people.w3.org/mike

Received on Wednesday, 3 March 2010 10:53:28 UTC