Wiki/Guidelines

From Apache OpenOffice Wiki
< Wiki
Revision as of 20:30, 28 March 2010 by B michaelsen (Talk | contribs)

Jump to: navigation, search

Project-independent guidelines

Template:Documentation/Note

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 binding for 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.

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