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

Re: reference in HTML5 differences document.

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>
Message-ID: <op.waha3kdtidj3kv@simons-macbook-pro.local>
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 GMT

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