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

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.

-Ben