W3C home > Mailing lists > Public > public-html@w3.org > April 2007

Re: Level of specification detail (Was Re: Proposal to Adopt HTML5)

From: Benjamin West <bewest@gmail.com>
Date: Thu, 12 Apr 2007 21:04:29 -0700
Message-ID: <8ad71be30704122104l4611f79fo13225cc71224c372@mail.gmail.com>
To: "Karl Dubost" <karl@w3.org>
Cc: "Maciej Stachowiak" <mjs@apple.com>, "Dan Connolly" <connolly@w3.org>, "Anne van Kesteren" <annevk@opera.com>, "Henrik Dvergsdal" <henrik.dvergsdal@hibo.no>, public-html@w3.org

On 4/11/07, Karl Dubost <karl@w3.org> wrote:
> With a bit of scripting, (and/or wikification), there might be a
> possibility for having something ala PHP documentation.  One of the
> cool things of PHP documentation is the breakdown of each feature
> with contributions from people. So not in the official specification
> but an annotated version of the new specification. Something similar
> had been done in the past with the [annotated XML Specification][1]
> by Tim Bray.
> [1]: http://www.xml.com/axml/testaxml.htm

Karl, I think this is a great idea.  Kind of a literate programming
mashup where rich, peer reviewed documentation is stored in the source
itself (or deeply cross-referenced).  How would you suggest interested
parties investigate this further?

Others: Ian is an excellent communicator.  I suggest concerned parties
read samples of his specs, and then comment on readability.  Anne's
suggestion is a good one.

Received on Friday, 13 April 2007 04:04:37 UTC

This archive was generated by hypermail 2.3.1 : Thursday, 29 October 2015 10:15:18 UTC