Merge pull request #212 from lhrc-mikeyp/readthedocs

A batch of docs changes - all formatting and markup fixes.