[#942] Add documentation guidelines
[#942] Typo
[#942] Fix broken toctree in docs
[#942] Typo
[#942] Move Commonly Used Terms higher up

in documentation guidelines
[#942] Add cross-referencing and linking examples
[#942] Add Sphinx seealso example
[#942] Don't use literals in section titles

It looks weird because the OKFN Sphinx theme colours them red.