So to be clear, this sync up of README.md is totally just trying to get in sync with whats on puppet-docs - I wasn't really trying to improve or change anything here ... just sync up with the version on puppet-docs. If you like I can remove this change completely so you can do it all on your sync-up.