General documentation

[SimonClifford]

This should include general user documentation rendered to readthedocs via Sphinx. There is also an option to include the API docs within this site (doxygen).

• Create a sensible Readme.md following the guidance in our handbook (development guide)
• Create walkthrough examples in the documentation.