On 14-10-11 20:14, Nigel Kersten wrote:
> 
> 
> On Fri, Oct 14, 2011 at 11:11 AM, Jacob Helwig <ja...@puppetlabs.com
> <mailto: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 <mailto: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. 

Exactly what I meant!

FWIW, I knew where to find the docs for my particular version, but I just
have 'latest' in my bookmarks.

I did not know about 'puppet describe <type>', which is pretty nice! Thanks!

Best regards,
Martijn Grendelman

-- 
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