New WP manual

[Addison Berry]

Not sure how many of you are familiar with the WordPress Codex, which
is their online wiki-style documentation. Apparently Automattic is
getting ready to write a more controlled "manual" which will be in XML
and stored in SVN. Interesting in light of current discussions for us
about the new help system in core and what to do about the Getting
Started guide.

For anyone interested, here is the link to their mailing list
discussion about it. http://comox.textdrive.com/pipermail/wp-docs/2009-January/001862.html

- Addi

--
Pending work: http://drupal.org/project/issues/documentation/
List archives: http://lists.drupal.org/pipermail/documentation/

[Morbus Iff]

Post by Addison Berry
Not sure how many of you are familiar with the WordPress Codex, which
is their online wiki-style documentation. Apparently Automattic is
getting ready to write a more controlled "manual" which will be in XML
and stored in SVN. Interesting in light of current discussions for us
about the new help system in core and what to do about the Getting

They don't get into more detail about which XML format they'd be using.
If we did something similar, I'd only support Docbook and Docbook Lite,
as there are plenty of existing converters for that (both to HTML, and
to files suitable for printing; the entire Apache Cookbook from O'Reilly
was written this way).

[Morbus Iff]

Post by Morbus Iff
They don't get into more detail about which XML format they'd be using.
If we did something similar, I'd only support Docbook and Docbook Lite,
as there are plenty of existing converters for that (both to HTML, and
to files suitable for printing; the entire Apache Cookbook from O'Reilly

Actually, they seem to infer Docbook Lite, if you read more closely:

"The handbook will be in XML form tied to Subversion (SVN)"
"It will also include options for HTML and PDF versions"

etc., which is all things you can already do with Docbook Lite. And:

http://svn.collab.net/repos/svn/trunk/doc/tools/readme-dblite.html