XWiki.org Documentation Reorganization (batch 3)

As a continuation of the proposal regarding the Navigation Tree, here are some more clearly defined rules for positioning pages within the navigation:

Positioning Pages in the Nav Tree

Once it has been decided which extension or subject a page belongs to, for Option 1 and 3, we need a strategy to decide its position within the navigation tree. Choosing the order can be quite subjective, but the following criteria should be considered:

  • List pages from most useful to less useful, considering how often a feature is used.
  • Use the Common Criteria to help decide.
    • For example, both “Hide a Page” and “Change the Syntax” belong under “Page”. “Hide a Page” is listed before “Change the Syntax” because hiding a page is used more frequently, while choosing a syntax usually happens only when creating a page.
    • Another example: the standalone WYSIWYG editor, also under “Page”, has a very specific use case, so it should be listed lower in the tree.