Puppet doc update

Expanding upon what @nhr added from the puppet repo docs.

@kraman have a look and merge/build if satisfactory.