On Thursday, May 10, 2012 10:10:56 AM UTC-7, Ken Barber wrote:
> I think your tone is a little trollish Philip - can we be more civil > please? I'm just trying to help. > Okay, sorry. One man's humor is another man's trolling, I suppose. So here's plain and boring: > > ( custom types go in (MODULEDIR)/lib/(?somewhere?) -- hey another > bug, it > > doesnt say specifically where under lib it goes ) > > On the page I sent you: > > http://docs.puppetlabs.com/puppet/2.7/reference/modules_fundamentals.html > > Under the lib directory it states: > > Contains plugins, like custom facts and custom resource types. See > “Using Plugins” for more details. > > Which redirects you to a hyperlink explaining the layout: > > http://docs.puppetlabs.com/guides/plugins_in_modules.html > I understand that on the "deeper" linked page, it may clear things up. But most people dont read manuals from cover to cover. Nor do they normally do a "depth first parsing" of documentation trees. They tend to first read the bits that seem to be most relevant to them. The top level needs to more noticably spell out to the reader, "hey pay attention, this bit(lib dir) is very different, you should go read the detail page to understand it more." > If you want to raise concrete bugs on > docs or code, I'm happy to show you were these can be raised - There is also the "concrete bug" of the inconsistency of location I mentioned, for custom types. -- You received this message because you are subscribed to the Google Groups "Puppet Developers" group. To view this discussion on the web visit https://groups.google.com/d/msg/puppet-dev/-/8HXBJUIBWNgJ. 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-dev?hl=en.
