- From: Simon Pieters <simonp@opera.com>
- Date: Thu, 01 Mar 2012 07:31:58 +0100
- To: "Steve Faulkner" <faulkner.steve@gmail.com>, "Maciej Stachowiak" <mjs@apple.com>
- Cc: "HTMLWG WG" <public-html@w3.org>
On Wed, 29 Feb 2012 22:47:54 +0100, Maciej Stachowiak <mjs@apple.com> wrote: > > 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. OK. Why? > 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. The references are automated, so I can't change their style at all. > Referencing only the WHATWG draft is odd for the reasons pointed out by > Steve, among others. I did not see any reasons pointed out by Steve. He said he was confused, asked whether the intention was to describe HTML5 or HTML, and provided suggestions for both cases. I have described my intention in the bug. What are the "among others" reasons? > 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 >> >> > -- Simon Pieters Opera Software
Received on Thursday, 1 March 2012 06:34:23 UTC