W3C home > Mailing lists > Public > public-html@w3.org > February 2012

Re: reference in HTML5 differences document.

From: Maciej Stachowiak <mjs@apple.com>
Date: Wed, 29 Feb 2012 13:47:54 -0800
Cc: Simon Pieters <simonp@opera.com>, HTMLWG WG <public-html@w3.org>
Message-id: <62040B3D-DFEE-4811-8D9A-5DB32320B53E@apple.com>
To: Steve Faulkner <faulkner.steve@gmail.com>

I think it would be better to have the draft continue to refer to HTML5, describe the differences between HTML5 and HTML4, and to update the reference. Here are examples of how some other W3C drafts reference HTML5 (pasting as HTML to show how the references are done):

HTML Canvas 2D Context <http://www.w3.org/TR/2dcontext/>:

[HTML5]
HTML5, I. Hickson. W3C.

Cross-Origin Resource Sharing <http://www.w3.org/TR/cors/>

[HTML5]
HTML5 (work in progress), I. Hickson. W3C.
HTML5 (work in progress), I. Hickson. WHATWG.

Web Intents <http://dvcs.w3.org/hg/web-intents/raw-file/tip/spec/Overview.html#references>

[HTML5]
Ian Hickson; David Hyatt. HTML5. 25 May 2011. W3C Working Draft. (Work in progress.) URL: http://www.w3.org/TR/html5

Other than the outdated author information on the last one, any of these styles seems ok. Referencing only the WHATWG draft is odd for the reasons pointed out by Steve, among others.

Regards,
Maciej



On Feb 29, 2012, at 9:56 AM, Steve Faulkner wrote:

> Hi Simon
> 
> I noticed your recent resolution of bug 14319 (https://www.w3.org/Bugs/Public/show_bug.cgi?id=14319)
> 
> I am now confused, is the 'HTML5 differences from HTML4' [1] document about differences between the HTML5 spec and HTML 4 spec or between the HTML living standard?
> 
> If it is the former then it should reference the HTML5 spec and not the HTML living standard.
> If it is the latter then the text needs to be changed so its is an accurate reflection of the document. There are 55 instances of  "HTML5" Suggest that all of these should be changed to "HTML living standard"
> 
> for example:
> 
> change "HTML5 differences from HTML4"  to "HTML living standard differences from HTML4"
> 
> change "HTML5 defines the fifth major revision of the core language of the World Wide Web, HTML. "HTML5 differences from HTML4" describes the differences between HTML4 and HTML5 and provides some of the rationale for the changes. This document may not provide accurate information as the HTML5 specification is still actively in development. When in doubt, always check the HTML5 specification itself. [HTML]"
> 
> 
> "HTML the living standard defines the fifth major revision of the core language of the World Wide Web, HTML. "HTML living standard differences from HTML4" describes the differences between HTML4 and HTML the living standard and provides some of the rationale for the changes. This document may not provide accurate information as the HTML living standard is permanently in development. When in doubt, always check the HTML living standard  itself. [HTML]"
> 
> 
> [1] http://dev.w3.org/html5/html4-differences/
> 
> -- 
> with regards
> 
> Steve Faulkner
> 
> 
Received on Wednesday, 29 February 2012 21:49:17 UTC

This archive was generated by hypermail 2.3.1 : Monday, 29 September 2014 09:39:30 UTC