Small clarifications and formatting changes

Can't figure out how to do this in Github, so I'm resubmitting here. 
I'll close #16.