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.
_______________________________________________
wp-docs mailing list
[email protected]
http://lists.automattic.com/mailman/listinfo/wp-docs
