To contribute documentation, simply put some words in a cunning order, and make their existence known to a developer. You can do this literally anywhere as long as a developer can see it. Once made aware, somebody will check it in for you. You should try to avoid proprietary formats, or locations that require authentication with methods other than Zot in order to make it easy for a developer to access, but even this is not a strict requirement.
If you wish to contribute directly, that's fine too. To contribute directly, documentation should be in one of the following formats:
Other formats are also allowed, but support for the format must be added to mod/help.php first.
If editing a plain text file, please keep column width to 80. This is because plain text is used in instances where we may not have a working installation - the installation documentation, for example - and it should be easy to read these from a CLI text editor.
The advantage of Markdown is that it is human readable.
The advantage of BBCode is that it is identity aware.
Therefore, if using BBCode, try to make the most of it:
To translate documentation, or provided documentation in languages other than English:
To create documentation that has no equivalent file in English, you can create a new file with a name of your choosing - but you'll also need to provide a localised version of the index page (main.bb in English) to make it accessible from the menu.
Return to the Main documentation page