[Puppet Users] Re: Module Plugin Documentation

2011-09-01 Thread jcbollinger
On Sep 1, 11:46 am, Douglas Garstang wrote: > For example, the very first sentence on the page starts with: > > "Learn how to distribute custom facts and types" > > How about a definition of what a custom fact and type are? Good > documentation generally doesn't assume that the reader knows all

Re: [Puppet Users] Re: Module Plugin Documentation

2011-09-01 Thread Douglas Garstang
For example, the very first sentence on the page starts with: "Learn how to distribute custom facts and types" How about a definition of what a custom fact and type are? Good documentation generally doesn't assume that the reader knows all the terminology being used without first defining or desc

[Puppet Users] Re: Module Plugin Documentation

2011-09-01 Thread jcbollinger
On Aug 31, 7:40 pm, Douglas Garstang wrote: > Anyone, > > I've read this doc several times: > > http://docs.puppetlabs.com/guides/plugins_in_modules.html > > As a whole, it really doesn't make sense. It seems pretty obvious it was > written by someone with deep knowledge of the subject, but ther