=====Guidelines for documentation contributors=====

WikkaWiki welcomes efforts to improve its official [[WikkaDocumentation | 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, [[WikkaDocumentation | 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 [[WikkaReleaseNotes | official releases]] should be linked from the [[WikkaDocumentation | 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 [[http://docs.wikkawiki.org/DocumentationTemplate/clone | DocumentationTemplate]]
~-Do not create documentation entries for features/actions that are not yet included in the [[WikkaReleaseNotes | 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