W3C home > Mailing lists > Public > whatwg@whatwg.org > May 2007

[whatwg] One document or two?

From: Julian Reschke <julian.reschke@gmx.de>
Date: Sat, 26 May 2007 12:54:56 +0200
Message-ID: <46581200.60009@gmx.de>
Nicholas Shanks wrote:
> Various people have expressed opinions in favour of either one spec to 
> rule them all, or two specs for different audiences. Is not the simplest 
> solution to have two views upon the same spec?
> 
> HTML 5, Full Version (User Agent Edition)
> "<foo> is deprecated and should not be used, but you have to support it 
> anyway."
> 
> HTML 5, Abridged Version (Web Author Edition)
> "<foo> is deprecated and should not be used."
> 
> 
> You can even have them at the same URL, with a pair of radio buttons to 
> toggle between them (which just toggles display: none on a class to hide 
> the unnecessary info:
> "&lt;foo> is deprecated and should not be used<span class="full">, but 
> you have to support it anyway</span>.")
> 
> Since I anticipate 99% or more of people who will read the document will 
> be HTML authors finding out about the new spec, Abridged should probably 
> be the default view.

I think this is definitely the right thing to do.

One more thing: although playing with client-side toggles and CSS may be 
interesting, I think the deliverables should clearly be two different 
documents, with different names at different URLs.

Best regards, Julian
Received on Saturday, 26 May 2007 03:54:56 UTC

This archive was generated by hypermail 2.4.0 : Wednesday, 22 January 2020 16:58:55 UTC