Small clarifications and formatting changes

Can't figure out how to do this in Github, so I'm resubmitting here. 
I'll close #16.
Merge pull request #28 from rippler/patch-11

Small clarifications and formatting changes