W3C home > Mailing lists > Public > public-html@w3.org > December 2008

Re: Authoring Guide

From: Asbjørn Ulsberg <list@asbjorn.ulsberg.no>
Date: Thu, 18 Dec 2008 16:49:20 +0100
To: "Lachlan Hunt" <lachlan.hunt@lachy.id.au>
Cc: "HTML WG" <public-html@w3.org>
Message-ID: <op.umc7khu6flu5h5@quark-mac-pro.local>

On Tue, 25 Nov 2008 21:49:19 +0100, Lachlan Hunt <lachlan.hunt@lachy.id.au> wrote:

> Yes, either here on public-html or on public-html-comments.

I've now read through large parts of the guide and have various comments ranging from complete paragraph rewrites to small typos, etc. I'd be most comfortable providing these comments through a diff of some sort, an SVN check-in, or something similar, instead of quoting and explaining a lot about each comment through e-mail.

What method for improvements like this would you prefer?

>> And what will be the relationship between the HTML5 specification and  
>> the authoring guide?
>
> I'm not sure I understand the question.  Could you please elaborate?

There's obviously a one-way relationship from the authoring guide to the HTML5 specification, but as I mention in the following paragraph, I'd like the relationship to be two-ways.

> Once it gets published as an FPWD, then informatively referencing the
> guide from the spec is possible, if there is somewhere in the spec from
> where such a reference would be appropriate.

I think having such a reference from the HTML5 specification is vital to the authoring guide's overall usefulness, discoverability and authority.

-- 
Asbjørn Ulsberg         -=|=-          asbjorn@ulsberg.no
«He's a loathsome offensive brute, yet I can't look away»
Received on Thursday, 18 December 2008 15:50:03 GMT

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