- From: Karl Dubost <karl@w3.org>
- Date: Mon, 18 Jun 2007 11:50:07 +0900
- To: Geoffrey Sneddon <foolistbar@googlemail.com>
- Cc: Dan Connolly <connolly@w3.org>, public-html@w3.org
Le 16 juin 2007 à 02:14, Geoffrey Sneddon a écrit :
>> Some might prefer to read what's there. Some might prefer to
>> write something new instead. Some prefer a mix of both,
>> I suppose.
>
> I think the first issue is this: what level/group are the follow
> aimed at:
> a) The "Writing HTML Documents" section of the spec,
> b) The WG tutorials.
>
> My suggestion would be to aim the former at people implementing the
> spec as a authoring tool or markup generator, and the latter at
> people hand-coding, probably starting by going over the extreme
> basics.
I propose this section to be renamed to clear up the
misunderstanding that we see often.
from "Writing HTML Documents"
to "Writing HTML Documents for markup producers"
Then a link to [Authoring tools and markup generators][2]
"Authoring tools and markup generators must generate conforming
documents. Conformance criteria that apply to authors also apply to
authoring tools, where appropriate."
btw there is no link
from the definition section (#editors)
to section 8.1 (#writing)
It will make possible another section or a link to an external
document a WG note for example on
"Writing HTML documents for authors"
[1]: http://dev.w3.org/cvsweb/~checkout~/html5/spec/
Overview.html#writing
[2]: http://dev.w3.org/cvsweb/~checkout~/html5/spec/
Overview.html#editors
--
Karl Dubost - http://www.w3.org/People/karl/
W3C Conformance Manager, QA Activity Lead
QA Weblog - http://www.w3.org/QA/
*** Be Strict To Be Cool ***
Received on Monday, 18 June 2007 02:52:30 UTC