Wiki/Guidelines

From Apache OpenOffice Wiki
< Wiki
Revision as of 15:57, 24 March 2008 by Discoleo (Talk | contribs)

Jump to: navigation, search

Some guidelines for using and creating new pages on OpenOffice.org's wiki

Intro

Information that cannot be found has no value. It is therefore imperative to make every information present on the wiki as accessible as possible to the broadest audience, both professionals and casual wiki readers.

There are a number of steps that should be followed in order to make the information on the wiki more accessible:

  • allow easy navigation by linking your wiki-pages using:
    • direct links from top-pages
    • page categories
    • subpages / hierarchical structures
  • easy recognition of page content
  • structuring the page itself

More formal Standard Operating Procedures (SOP) are available as drafts. The final (aproved) versions shall be followed by everyone.

Navigating and Contributing

Template:WikiInstructions

Headings

H1 is used for the title of a wiki page. Therefore it is better to start with "== Heading 2 ==" for your own content.

Categories

Categorize your pages. Choose a category from Special:Categories that makes sense, and apply it by adding [[Category:Whatever]] to your page. You can add more than one category to your page.

Example
Category:Project collects all "home pages" for OOo's projects.

Sub Folders

If you choose a name for your wiki page that conforms to the style "maintopic/subtopic" (mind the slash!), then you create a page that is automatically linked back to the page called maintopic. Sub folders are very useful for organising related content in a traditional way, and a hierarchical structure allows better search in specific areas of the wiki.

Example
MediaWiki Extension/Use Cases is a subpage to MediaWiki Extension

Related Pages

Personal tools