add :require to all gems in Gemfile
update README boilerplate sections, formatting, and ToC
add compatibility with older puppet 2.7.x