On Dec 7, 5:01 pm, "Christian G. Warden" <[email protected]> wrote:
> I hope this doesn't come off as too much of a rant. As a person who is frequently critical of some of the newer Puppet features -- especially parameterized classes -- I wouldn't have much standing to object to your criticisms. I would suggest, however, that you consider filing issue tickets against the documentation for some or all of your complaints. The sqeaky wheel gets the grease, and formal issue tickets squeak far louder than complaints in this forum. > I'm a big fan of puppet > (even more so in the past couple weeks as I've started using it with vagrant), > but there's definitely room for improvement in the documentation. Perhaps the > puppet glossary[5] should be featured on the documentation section of > puppetlabs.com, and existing documentation should be reviewed for consistency > with the glossary. Sounds good to me, but as a practical matter, it is likely that specific documentation issues will be fixed a lot sooner than a general documentation review such as you describe will be performed. On the other hand, the more documentation issues are open, the more likely I predict Puppetlabs will be to try to sweep many of them up at once with some kind of general review / rewrite. Oh, and since you mentioned PuppetLabs's style guide, I'll tell you that I don't care for it (the latest version) at all. It is focused on a style that caters to pervasive use of parameterized classes, and as far as I am concerned, parameterized classes should be considered harmful. If you're mostly or completely avoiding parameterized classes then the apparent reasons for many of the style recommendations, including some you touched on, just fall apart. John -- You received this message because you are subscribed to the Google Groups "Puppet Users" group. To post to this group, send email to [email protected]. To unsubscribe from this group, send email to [email protected]. For more options, visit this group at http://groups.google.com/group/puppet-users?hl=en.
