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

[html-author] Authoring Guide Progress Update

From: Lachlan Hunt <lachlan.hunt@lachy.id.au>
Date: Fri, 28 Nov 2008 03:40:56 +0100
Message-ID: <492F5A38.1090605@lachy.id.au>
To: public-html <public-html@w3.org>

Hi,
   I've made some recent progress with the authoring guide and just 
wanted to let people know what has happened with it so far.

http://dev.w3.org/html5/html-author/

Introduction

I've made some updates to the text in the introduction, trying to 
explain what HTML is and describing some of the common use cases for it. 
  Some of this was updated based on feedback I'd received at TPAC, 
asking for it to be simplified more and aimed at people who may have no 
prior experience or understanding of HTML.  It's still very much a work 
in progress and I'm also waiting for gsnedders to make his contributions 
to this section, as he agreed to do at TPAC.

http://dev.w3.org/html5/html-author/#introduction

Categories

I've incorporated the element category descriptions from the spec, but 
have significantly rewritten them in more simplified language and 
included notes to help authors understand the relationships between the 
categories.

http://dev.w3.org/html5/html-author/#categories

Element Descriptions

I've included more element descriptions into the document and begun 
simplifying their descriptions.  Much of this was copied and pasted 
directly from the spec and still includes a lot of stuff that will be 
removed and rewritten.  Not all elements have been included yet either.

http://dev.w3.org/html5/html-author/#the-root-element

-- 
Lachlan Hunt - Opera Software
http://lachy.id.au/
http://www.opera.com/
Received on Friday, 28 November 2008 02:41:35 GMT

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