On Fri, Oct 14, 2011 at 11:11 AM, Jacob Helwig <ja...@puppetlabs.com> wrote:

> On Fri, 14 Oct 2011 10:04:19 -0700, Nigel Kersten wrote:
> >
> > On Fri, Oct 14, 2011 at 7:05 AM, Martijn Grendelman <mart...@iphion.nl
> >wrote:
> >
> > > Hi,
> > >
> > > I have no idea if this has come up before, I didn't bother to check the
> > > archives or anything, but I was wondering if it would be possible to
> have
> > > Puppet's documentation reflect the version in which a certain feature
> was
> > > added.
> > >
> > > For example, I just added a user to my catalog using the 'system'
> > > parameter, as per
> > > http://docs.puppetlabs.com/references/latest/type.html#user:
> > >
> > >  system
> > >    Whether the user is a system user with lower UID. Valid values are
> > >    true, false.
> > >
> > > And now all my 2.6.3 nodes are complaining:
> > >
> > >  "Invalid parameter system at /etc/puppet/manifests/..."
> > >
> > > A little digging into the source revealed to me, that this feature is
> not
> > > present in 2.6.3, but it is in 2.7.5. I have no idea in what version it
> > > was introduced.
> > >
> > > It would be nice if the type reference would contain that information.
> > >
> > >
> > If you go to the Quick Nav menu, you can get to the docs for other
> versions:
> > http://docs.puppetlabs.com/references/
> >
> > Then:
> > http://docs.puppetlabs.com/references/2.6.11/type.html
> >
> > should contain what you need I believe ?
> >
>
> I think he wants something more along the lines of the "since" sections
> you can create with newer versions of YARD when documenting methods.
>
> For for example:
> http://rubydoc.info/gems/octocat_herder/0.1.1/OctocatHerder/PullRequest#diff_text-instance_method


That's pretty sweet.


-- 
Nigel Kersten
Product Manager, Puppet Labs

-- 
You received this message because you are subscribed to the Google Groups 
"Puppet Users" group.
To post to this group, send email to puppet-users@googlegroups.com.
To unsubscribe from this group, send email to 
puppet-users+unsubscr...@googlegroups.com.
For more options, visit this group at 
http://groups.google.com/group/puppet-users?hl=en.

Reply via email to