Fixed documentation compile warnings
added some more formatting around code blocks and literals
Merge pull request #832 from helenst/documentation-fixes

Documentation fixes