Announce: Puppet Language Style Guide 2.0

[Lauren Rother]

The Modules team and I are excited to finally announce the newest version of the Puppet Language Style Guide.

We've reworked the guide to reflect the new features and capabilities of Puppet 3.7, and we've expanded it to cover more topics related to building manifests and modules. If you're interested in publishing a module to the Puppet Forge or are looking to get your module "Puppet Approved," the updated guide is a great place to start.

It was a massive, company-wide effort to update this style guide, but I'm sure we didn't catch everything. If you notice a mistake or would like more information on something that's not currently covered, please file a ticket. We plan to regularly update the guide from here on out, and we definitely anticipate another big release in the months after Puppet 4 comes out.

Puppet Language Style Guide:
https://docs.puppetlabs.com/guides/style_guide.html

File a ticket:
https://tickets.puppetlabs.com/browse/DOCUMENT/

The Puppet Approved program:
https://forge.puppetlabs.com/approved

Thanks!
Lauren

--

Lauren Rother

Technical Writer

Puppet Labs, Inc.

[Lauren R]

A big thanks to everyone for all the feedback! It's pretty awesome to work on a project that people care so much about.

Here's what's happening:

We gathered all the comments, suggestions, and opinions in a document and walked through each one. Some small things (that completely block understanding) are being updated now (expect a z release early next week). The bigger things were logged in a public ticket and will be addressed in the next version of the guide, slated to come out sometime after Puppet 4.0 launches. 

Again, thank you for all the discussion, pull requests, and insight. Puppet people are some of my favorite people ever.

Track the updates ticket here: https://tickets.puppetlabs.com/browse/DOCUMENT-266

Best,

Lauren