|
Tim Schaefer |
at May 28, 2013 at 8:42 pm
|
⇧ |
| |
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 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" 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.sorenson@puppetlabs.com> wrote:
http://docs.puppetlabs.com/references/latest/configuration.htmlTop 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+unsubscribe@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
asysarchitect@gmail.comweb 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+unsubscribe@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+unsubscribe@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
asysarchitect@gmail.comweb 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+unsubscribe@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.