On Sat, Aug 9, 2014 at 11:16 AM, Nan Liu <nan....@gmail.com> wrote: > > +1, anything dry that makes documentation less of a chore. There's a lot > of things we can already infer from the module layout, and I like docco > style embedding of documentation because you need to reference the puppet > source code in a lot of cases. > > > Agreed. Back in the 0.25 days at a former employer, I had a wonderful script that would generate manifest docs and publish them to a web server on every push to the repo. That's been much less useful lately, and I'd love to see it work again. +1 for anything that lets me generate useful docs instead of documenting every param in the file header... and then again in README.md.
-- You received this message because you are subscribed to the Google Groups "Puppet Developers" group. To unsubscribe from this group and stop receiving emails from it, send an email to puppet-dev+unsubscr...@googlegroups.com. To view this discussion on the web visit https://groups.google.com/d/msgid/puppet-dev/CAFt4V4n321r0PsAsrwvbm8U3boAazc6DfCLmoy4DQiv655XvPQ%40mail.gmail.com. For more options, visit https://groups.google.com/d/optout.