The puppet language has a simple documentation syntax. You can find the syntax on the Puppet Manifest Documentation Wiki page. The puppet doc command leverages this syntax for automatic generation of RDoc or HTML documents for modules and manifests.