Rewrite the docs to fit the current best practices for Puppetlabs
modules.
add README section on API deprecations since version 1.0.0
Merge pull request #1 from jhoblitt/docs-change

add README section on API deprecations since version 1.0.0
Merge pull request #114 from apenney/docs-change

Rewrite the docs to fit the current best practices for Puppetlabs