Back in October Nan Liu announced
"pocco - a puppet manifest documentation experiment" as a way of
generating much nicer looking documentation for puppet classes (you can see
an example and reducing the amount of boilerplate needed
to document your classes.
After some issues with the ruby libraries it depends on, I ran it over a couple of my smaller manifests and I have to say the output is very readable and quite presentable. If you write manifests for other peoples use then this is well worth a look.
Like this post? - Digg Me! | Add to del.icio.us! | reddit this!