Re: reference in HTML5 differences document.

On Feb 29, 2012, at 10:31 PM, Simon Pieters wrote:

> 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?

Reasons for all of the above:

- The document is titled "HTML5 differences from HTML4", so you'd expect it to contain what the title says.
- Document is published by the W3C, so you would expect it to at minimum cite relevant W3C drafts, even when there are also versions published elsewhere.
- Most W3C documents that cite HTML5 either cite only the W3C draft, or cite HTML5 in addition to WHATWG HTML as a single reference.

Per your comments in the bug, it seems like you intend to do this, but would also like to describe differences that only affect WHATWG HTML, though clearly marked distinctly, and to cite both versions of HTML/HTML5 once your toolchain supports it.

In my (personal, non-Chair) opinion, that seems like a fine approach. As long as the document includes HTML5 differences from HTML4, it seems ok to me for it to also document other differences, as long as it is clear what's what. Since what you plan to do seems fine to me, I don't think we need to debate the reasons for it further.

Regards,
Maciej

Received on Thursday, 1 March 2012 23:31:06 UTC