Information Architecture

In the conversion from the old, crufted wiki, it's important to establish some standards and conventions for keeping the new wiki organized, relevant and useful. This page attempts to collect those.

Naming Pages

When creating links to new pages it is preferrable to uses spaces instead of WikiWords. For example, the following is undesirable:

[[PageName]]

and should instead be written as:

[[Page Name]]

The page name is used as the page title, and this helps make those easily human readable.

Categories

Categories allow the MediaWiki software to create an index of pages about a specific topic. Pages can have multiple topic tags attached to them. Current category standards we're using here:

[[Category:Developer]]

Marks a page as developer related.

[[Category:CcPublisher]]

Marks a page as ccPublisher related; note that you could substitute any string for ccPublisher (and should if a project has more than a couple of pages).

So for a ccPublisher page with developer content we would add the following category declarations to the top of the page:

[[Category:Developer]]
[[Category:CcPublisher]]

Page Tags

If a page is a stub (just a placeholder), incomplete or out of date, add one of the following lines to the top so that visitors can obviously see that:

  {{stub}}
  {{incomplete}}
  {{needs updated}}