W3C home > Mailing lists > Public > public-html@w3.org > June 2007

Renaming "writing HTML 8.1" - Re: mixed signals on "Writing HTML documents", tutorial, etc.

From: Karl Dubost <karl@w3.org>
Date: Mon, 18 Jun 2007 11:50:07 +0900
Message-Id: <B88A5C3C-789F-473A-BF0A-4ED7DADA1915@w3.org>
Cc: Dan Connolly <connolly@w3.org>, public-html@w3.org
To: Geoffrey Sneddon <foolistbar@googlemail.com>


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 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Wednesday, 9 May 2012 00:16:01 GMT