>> 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."
Sounds fair enough, if you think you have a clear idea of how you would like the prose to be changed on that particular docs page, put a proposal together and submit it as a ticket in Redmine: http://projects.puppetlabs.com/projects/puppet-docs Where it can be discussed. >> 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. What bug do you mean? The path to types? The location to types is documented here: http://docs.puppetlabs.com/guides/plugins_in_modules.html "custom types should go in lib/puppet/type/" What I wrote in email was wrong yes - what I meant to say was: <snip> You want your type here: <module_name>/lib/puppet/type/<type_name>.rb And provider here: <module_name>/lib/puppet/provider/<type_name>/<provider_name>.rb </snip> I was writing that from scratch - not copying from docs - I just truncated the path - sorry about that. ken. -- You received this message because you are subscribed to the Google Groups "Puppet Developers" 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-dev?hl=en.
