W3C home > Mailing lists > Public > public-html@w3.org > January 2009

Re: ISSUE-59: normative-language-reference FPWD

From: Ian Hickson <ian@hixie.ch>
Date: Fri, 23 Jan 2009 11:55:23 +0000 (UTC)
To: Steven Faulkner <faulkner.steve@gmail.com>
Cc: Sam Ruby <rubys@intertwingly.net>, HTML WG <public-html@w3.org>
Message-ID: <Pine.LNX.4.62.0901231153060.11411@hixie.dreamhostps.com>

On Fri, 23 Jan 2009, Steven Faulkner wrote:
> Ian wrote:
> > Could we add a section to the document that describes the intended
> > audience? It would help with reviewing the document if there was a clear
> > description of who the document was written for.
> 
> isn't it covered under 1. Introduction and Scope [1]?
> 
> "This specification limits its scope to providing the details
> necessary for HTML producers to create conformant documents."
> 
> "HTML producers
> HTML authors (that is, people) and applications (such as editors and
> content management systems) that produce HTML content."
> 
> [1] http://www.w3.org/html/wg/markup-spec/#intro

The "Out of scope" section clearly states that HTML authors and 
implementors of authoring tools aren't the target audience (e.g. it 
excludes the APIs, needed by authors for many aspects of HTML5, and it 
excludes the parser, needed by most authoring tool vendors).

That's why I think an explicit audience section would be helpful.

-- 
Ian Hickson               U+1047E                )\._.,--....,'``.    fL
http://ln.hixie.ch/       U+263A                /,   _.. \   _\  ;`._ ,.
Things that are impossible just take longer.   `._.-(,_..'--(,_..'`-.;.'
Received on Friday, 23 January 2009 11:55:58 GMT

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