Create documentation guidelines

[dgn]

Let's write down some basic rules on what we think documentation should look like. Should include rules on

• inlining vs. linking of examples
• formatting
• nomenclature
• file structure
• ...

[fjglira]

Assign to me because it is related to #454, and to be able to set the rules for the automatic script to run the test, we will need these guides