Tidied up the docs source

In preparation for moving all the docs to RTD which seems like the most
sensible new home for them given the deficiencies in the GH wiki