Puppet docs are the last place I look not the first place, and that's my annoyance with the documentation.
Clear, complete, unambiguous, working docs with real-world examples are what we need. It gets really annoying to have to download modules from forge and have to wade through code to see what is the correct approach is, especially when so many modules don't have documentation either. pe_accounts is a classic example of incomplete, confusing documentation. Some of it just makes no sense at all, especially since it has no authoritative examples that are complete enough to use. No docs on how to set up external data sources. Very annoying and ironic, since Puppet is supposed to save me time. Instead I find myself constantly hunting for examples. Anyway I did find the snippet of information at the top of the doc, where I would never expect to see it. Tim On Tue, May 28, 2013 at 12:58 PM, Matthew Kennedy <mattkenn4...@gmail.com>wrote: > It is there, just where Eric said it was. No need to get upset. > > It might be helpful to mention where the time notation format can be found > in the sections where it is used. Would preempt issues like this in the > future. > > Matt > On May 28, 2013 1:46 PM, "Tim Schaefer" <asysarchit...@gmail.com> wrote: > >> Item 175: runinterval >> >> How often puppet agent applies the client configuration; in seconds. Note >> that a runinterval of 0 means “run continuously” rather than “never run.” >> If you want puppet agent to never run, you should start it with the >> --no-client option. Can be specified as a duration. >> >> - *Default*: 30m >> >> >> So, do I put 15m? 900? 900s? There is nothing there that says anything >> you just said. >> >> None of what you said is in the runinterval documentation. This is the >> first I've ever seen it. You need to update your docs. >> >> And don't tell me to go over to forge, that's a lazy, inexcusable >> response. You can do better. I don't mind hacking but really when there >> is no where else to find this information you have a responsibility to >> document in a clear, unambiguous form. >> >> Thanks, >> >> Tim >> >> >> >> On Tue, May 28, 2013 at 12:07 PM, Eric Sorenson < >> eric.soren...@puppetlabs.com> wrote: >> >>> http://docs.puppetlabs.com/references/latest/configuration.html >>> >>> Top of the page, just under the headers: >>> >>> Settings that represent time intervals should be specified in duration >>> format: an integer immediately followed by one of the units ‘y’ (years of >>> 365 days), ‘d’ (days), ‘h’ (hours), ‘m’ (minutes), or ‘s’ (seconds). The >>> unit cannot be combined with other units, and defaults to seconds when >>> omitted. Examples are ‘3600’ which is equivalent to ‘1h’ (one hour), and >>> ‘1825d’ which is equivalent to ‘5y’ (5 years). >>> >>> >>> On Tuesday, May 28, 2013 7:07:34 AM UTC-7, Tim Schaefer wrote: >>>> >>>> OK so is it minutes or seconds for runinterval? >>>> >>>> And what's the correct format!!!! >>>> >>>> Please put an example in the docs!!!!! >>>> >>>> Do I use 15m for 15 minutes or is it 900 for 900 seconds????? >>>> >>>> I hate ambiguity in documentation!!!!! Be precise! >>>> >>> -- >>> You received this message because you are subscribed to a topic in the >>> Google Groups "Puppet Users" group. >>> To unsubscribe from this topic, visit >>> https://groups.google.com/d/topic/puppet-users/fBC1VXt9nPA/unsubscribe?hl=en >>> . >>> To unsubscribe from this group and all its topics, send an email to >>> puppet-users+unsubscr...@googlegroups.com. >>> To post to this group, send email to puppet-users@googlegroups.com. >>> Visit this group at http://groups.google.com/group/puppet-users?hl=en. >>> For more options, visit https://groups.google.com/groups/opt_out. >>> >>> >>> >> >> >> >> -- >> Tim Schaefer >> iphone 650-839-3277 >> voip 650-646-9636 >> email asysarchit...@gmail.com >> web A System Architect <http://www.asystemarchitect.com> >> skype asystemarchitect >> >> -- >> You received this message because you are subscribed to the Google Groups >> "Puppet Users" group. >> To unsubscribe from this group and stop receiving emails from it, send an >> email to puppet-users+unsubscr...@googlegroups.com. >> >> To post to this group, send email to puppet-users@googlegroups.com. >> Visit this group at http://groups.google.com/group/puppet-users?hl=en. >> For more options, visit https://groups.google.com/groups/opt_out. >> >> >> > -- > You received this message because you are subscribed to a topic in the > Google Groups "Puppet Users" group. > To unsubscribe from this topic, visit > https://groups.google.com/d/topic/puppet-users/fBC1VXt9nPA/unsubscribe?hl=en > . > To unsubscribe from this group and all its topics, send an email to > puppet-users+unsubscr...@googlegroups.com. > To post to this group, send email to puppet-users@googlegroups.com. > Visit this group at http://groups.google.com/group/puppet-users?hl=en. > For more options, visit https://groups.google.com/groups/opt_out. > > > -- Tim Schaefer iphone 650-839-3277 voip 650-646-9636 email asysarchit...@gmail.com web A System Architect <http://www.asystemarchitect.com> skype asystemarchitect -- You received this message because you are subscribed to the Google Groups "Puppet Users" group. To unsubscribe from this group and stop receiving emails from it, send an email to puppet-users+unsubscr...@googlegroups.com. To post to this group, send email to puppet-users@googlegroups.com. Visit this group at http://groups.google.com/group/puppet-users?hl=en. For more options, visit https://groups.google.com/groups/opt_out.