1.2 KiB
Writing Documentation
Your documentation needs to go in the specific modules docs folder which it refers mostly too. For example if you want to document a feature of your custom module 'MyModule' you need to create markdown files in mymodule/docs/.
The files have to end with the .md extension. The documentation viewer will automatically replace hyphens (-) with spaces (since you cannot have spaces web / file systems).
Also docs folder should be localized. Even if you do not plan on using multiple languages you should at least write your documentation in a 'en' subfolder
/module/docs/en/
Syntax
This uses a customized markdown extra parser. To view the syntax for page formatting check out [http://daringfireball.net/projects/markdown/syntax][Daring Fireball]
Creating Hierarchy
The document viewer supports folder structure. There is a 9 folder limit on depth / number of sub categories you can create. Each level deep it will generate the nested urls.
Directory Listing
Each folder you create should also contain a index.md file (see sapphiredocs/doc/en/index.md) which contains an overview of the module and related links.
Table of Contents
The table of contents on each module page is generated