- From: Benjamin West <bewest@gmail.com>
- Date: Thu, 12 Apr 2007 21:04:29 -0700
- 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. -Ben
Received on Friday, 13 April 2007 04:04:37 UTC