Skip to content

Documentation documentation


This document is a work in progress. It is not complete, and as such should not be "trusted" for guidance.

A MarkDown template document can be found here

Page contents

Page title

Always put a page title at the top, preferably using the same wording as in the left side navigation menu, or longer (more precise) if you had to shorten the menu title. This quickly brings us to:


The documentation uses four levels of Headers. Note the space after the hash-signs. The headers used in the document are also used to create the structure shown to the right of the text.

This is only used for the Page title

# First level header

Used for main sections of a page.

## Second level header
### Third level header
#### Fourth level header


If you feel that your page needs more than one top-level header (#), consider breaking the page up into two (or more).

If you feel that you need more subheaders than level four (####), try to find a different way to layout your page, using e.g. a tabbed section like the one above.

Text formatting

Text can be bolded, italicized, or both.

    Text can be **bolded**, *italicized*, or ***both***.



Stock images


Try to keep screenshots as clean as possible, only showing the windows or sections that are described in the text.

Avoid using actual email adresses, staff names etc in screenshots. Apart from the risk of receiving unwanted emails and such, it also makes the documentation harder to keep up to date in case of people changing jobs etc.


Code and code blocks are added to a document using three backticks at the beginning and end. The syntax for Code blocks looks like this:


Whereas the syntax for inline code looks like this:

Whereas the syntax for ```inline code``` looks like this:


Admonitions are boxes used for notes, warnings or advice. They come in a variety of styles, but the mainly used ones are Note, Info, Tip, Warning and Important.

The MarkDown code for Admonitions is:

!!! info
    All text in the Admonition box must be tabbed one step in to the right.

    The Admonition ends when text starts flowing from the original tab position.


All text in the Admonition box must be tabbed one step in to the right.

The Admonition ends when text starts flowing from the original tab position.

Below are the different styles that are normally used:


This Admonition is started with !!! important.


This Admonition is started with !!! info.


This Admonition is started with !!! note.


This Admonition is started with !!! tip.


This Admonition is started with !!! warning.

The footer code is as follows (including the three hyphens that make a line between the page and the footer):



Your Name


2022-10-10 (substitute your date)



Keep the language as simple yet precise as possible.

  • Check the Commonly used phrases and terms page for important words and concepts that you are using. Do not hesitate to add to the list if you are writing about new concepts that are missing.


British or american spelling (e.g. colour - color)?

Final notes


Peter Bergdahl