[wp-docs] Intro

[Matthew Paul Thomas]

On Dec 6, 2006, at 2:00 PM, Mark Styles wrote:
>
> On Tue, Dec 05, 2006 at 12:50:02PM -0800, Matt Mullenweg wrote:
>>
>> What are your thoughts on the current organization of the 
>> documentation and how it could be improved?
>
> I like the idea of starting with a book metaphor and expanding from
> that. Defining a small set of "chapters" and an even smaller set of
> "appendices" and assigning all content to one chapter or appendix.
> Hyperlinking within the content will still let people jump around
> wherever they want but there would be an underlying start to finish
> organisation.
> ...

Ironically, in Ubuntu we're (slowly) moving in the opposite direction 
-- fewer book-style manuals and guides with chapters, and more 
individual pages on specific topics. 
<https://wiki.ubuntu.com/TopicBasedHelp> Similar will eventually happen 
for the Gnome system on which Ubuntu is based.

Cheers
-- 
Matthew Paul Thomas
http://mpt.net.nz/