Documentation fixes

[espenhgn]

Fixes #169
Fixes #120

Changes proposed in this pull request:

• Redo documentation using cross links between markdown docs that works via Sphinx-Myst extension as well as GitHub.com

Before submitting

• I've read and followed all steps in the Making a pull request
  section of the CONTRIBUTING docs.
• I've updated or added any relevant docstrings following the syntax described in the
  Writing docstrings section of the CONTRIBUTING docs.
• If this PR fixes a bug, I've added a test that will fail without my fix.
• If this PR adds a new feature, I've added tests that sufficiently cover my new functionality.