reformat comments and clarify rspec config