Use markdown files for building docs

[creisle]

• use markdown instead of rst for building docs. And build user manual with mkdocs and markdown_refdocs
• this is more readable for editing individual files
• will need to test that this is still publishable via readthedocs