fix formatting of and typos in comments

Its a little penny ante, but I'm on a plane and `bundle install` is slow so I'm reading code instead..