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

Re: Authoring Guide

From: Jonas Sicking <jonas@sicking.cc>
Date: Tue, 25 Nov 2008 13:39:04 -0800
Message-ID: <492C7078.7070304@sicking.cc>
To: Lachlan Hunt <lachlan.hunt@lachy.id.au>
CC: Asbjørn Ulsberg <list@asbjorn.ulsberg.no>, HTML WG <public-html@w3.org>

Lachlan Hunt wrote:
> 
> Asbjørn Ulsberg wrote:
>> On Tue, 25 Nov 2008 02:37:48 +0100, Lachlan Hunt 
>> <lachlan.hunt@lachy.id.au> wrote:
>>> The authoring guide, of which I am the current editor...
>>
>> I wasn't aware of the authoring guide before this, and after skimming
>> through, it seems like a large step in the right direction. What is 
>> the best place to discuss this guide? Here on the HTML WG list?
> 
> Yes, either here on public-html or on public-html-comments.
> 
>> 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?
> 
>> The authoring guide will of course reference the HTML5 specification, 
>> but what about the other way around? Can an informative reference to 
>> the authoring guide be present in the HTML5 specification?
> 
> 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 definitely think that we should have such an informal reference 
somewhere close to the top of the spec. Anything we can do to attract 
attention to the authoring guide is a good thing IMHO. We do want both 
HTML authors as well as tutorial authors to read this document.

/ Jonas
Received on Tuesday, 25 November 2008 21:42:09 GMT

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