===== Guidelines ===== Please try to follow this Guidelines. :-) ==== ==== - 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======%%)