Documentation updates

A few minor updates that cover the gaps highlighted in #152 and also do some cleaning up in the process.