Guidelines for documentation contributors
WikkaWiki welcomes efforts to improve its official documentation.
This page contains all the necessary information for users willing to write documentation pages.
General documentation guidelines
To preserve the overall consistency of documentation pages, please respect the following guidelines when creating/editing a documentation page.
- When creating a new documentation entry, check first that another page on the same topic does not already exist. Redundant documentation can be confusing.
- Use plain, understandable English and avoid using a technical lexicon, unless you are writing developer documentation.
- Documentation code for the end user should not contain code blocks.
- Documentation pages for features/actions included in official releases should be linked from the Wikka Documentation page
- Each documentation page should be formatted following the template below:
[[WikkaDocumentation | Wikka Documentation]] ---- =====Title of the page ===== Here goes page content ... ... ... ... ---- CategoryDocumentation
- You can directly generate well-formatted documentation pages by "cloning" the DocumentationTemplate
- Do not create documentation entries for features/actions that are not yet included in the official Wikka releases
- When writing documentation pages, try to add links to keywords whenever the text allows it. For instance, when referring to the release notes you should add a link to WikkaReleaseNotes like [[WikkaReleaseNotes | official releases]].
CategoryWelcome