Resolve "format documentation"

Closes #22 (closed) , might make more sense to open another formatting issue at the end to tidy everything up, so merging for now to avoid conflicts when names change.