This doesn't follow the style guide: http://docs.puppetlabs.com/guides/style_guide.html#puppet-doc ... in puppetdoc it will render quite plain basically :-).

But honestly I'm more worried about this being documented in the README.md as this is what most people read - as its the prominent piece on the forge and github.