[wp-docs] Intro

[Jerry Peek]

An overall Table of Contents that lists all of the content would be a 
big help.  That would let people know "where they are" and to be fairly 
sure that they've seen all of the material on a particular topic.  (I 
wrote earlier that the links pointing to pages of other links confuse 
me.)  If it's possible to have chapter and section numbers (which would 
change as new material is added, of course), that might help more.

Since Codex is maintained by its readers, though, I wonder if the 
more-ordered book-like structure could eventually break down as people 
put new content wherever they think it should go.  If they don't have a 
good understanding of the whole structure, they might not put content in 
the best place.  (I don't have much experience with group-edited 
documentation, though.  Maybe this isn't a problem.)

Jerry

On Tue, 05 Dec 2006 20:00:04 -0500, Mark Styles wrote:
 > 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. Moving some of the more esoteric stuff to the appendices
 > might also make navigation of the core stuff clearer and easier.