What are the basic guidelines for adding new content?
- Write in a clear and easy to understand way.
- Contribute only original material. Links are fine, but don't cut-and-paste from copyrighted sources.
- Avoid unnecessary layers; they make content hard to find and
hard to follow. Consider for example how in a book, the appendices are
on the same level as "chapters" of the book. - Do not use hierarchical structure to achieve the desired
sequence. - Avoid nearly-empty "container" pages.
- Introductory material should normally be in the parent page, not a first child page, in a large multi-page topic.
- Short child pages covering a particular variation should be
incorporated into the parent page if practical. This is particularly
true for single child pages. - Avoid duplication; it is better to link to existing
documentation about a topic, rather than duplicate it (or nearly
duplicate it) in a second location where it may be applicable. - Ensure the parent page is organizationally named. Remember
that a user starting at the top sees only one layer of titles at a
time. Would someone looking for the topic on your page naturally select
its parent from those available? - Test the structure: Start at the top, and select the path a
new user would if looking for your topic. - Monitor forum requests for information: If you have added content,
but a forum inquiry indicates it couldn't be found, consider whether
the book structure is unclear for a new user looking
for the topic. If replying to the forum inquiry, rather than just providing a link to the page, provide
the path to the page as well.