There are three types of pages:
Start pages of namespaces
Feature description
Tutorials
Each namespace has a start page with the same name
Each start page follows the structure:
Title
Short summary
List of the summary of all pages in the namespace
Each feature description page follows the structure:
Title
Short summary
Link to tutorials
Description
Further features (?)
Each feature description page describes only one feature
Each Tutorial page follows the structure:
Title
Short summary
Link to explained features
Expected knowledge + reference to where to find
Required material
link if from other tutorial
Tutorials
Final result (if existing)
Further tutorials(?)
Tutorials are combined with guides:
Each guide has a start page:
with a short description
a list of the included tutorials (auto-generated by DocNavigation)
Tutorials are linked as a new page with navigation and reference to the original page
The depth of a subsection has to stay below 4
Naming pages and subsections:
begin with a two digit number (01_) to define the order on the menu and summaries
no capital letters allowed
words are separated by underscore
Titles of pages start with headline level 1 (====== title======)