Consider mgirating all documentation from reStructuredText to Markdown

[Delgan]

We already migrated the Readme (see ef12cbb), we should also migrate the rest of the documentation for consistency and because Markdown is simpler overall.