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

Comments on the HTML 5 Web Dev Guide

From: Justin Thorp <juth@loc.gov>
Date: Tue, 27 Nov 2007 17:07:23 -0500
Message-Id: <474C4ECB020000D800022D6D@ntgwgate.loc.gov>
To: "public-html@w3.org" <public-html@w3.org>

I just went through the current iteration of the "The Web Developer’s
Guide to HTML 5."  I have some comments...

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

I think we need to explicitly have sections called "What is HTML 5?"
and "Why HTML 5 is important".  A lot of Web developers are out there
today using what they have.  We need to make a case for why they should
care.  How is HTML 5 going to make their life better?

Something more then...
"The main area that has not been adequately addressed by HTML is a
vague subject referred to as Web Applications. HTML5 attempts to rectify
this..."

*1.1.2. Example Markup*
http://dev.w3.org/html5/html-author/#example

I'm not completely clear to how HTML 5 relates to HTML and XHTML.  So
you can use XHTML-ish coding practices when writing HTML 5?  This needs
to be clarified, otherwise having examples from HTML and XHTML is going
to be terribly confusing.

*4.1.1. The body element*
http://dev.w3.org/html5/html-author/#the-body

I'm not sure what you mean when you talk about things like "Content
model" and "DOM interface."  Can you elaborate?


I'm sure i'll have more later...

cheers,
Justin Thorp



******************
Justin Thorp
US Library of Congress
Web Services - Office of Strategic Initiatives
e - juth@loc.gov
p - 202/707-9541
Received on Tuesday, 27 November 2007 22:08:19 GMT

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