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 -- Jacob Helwig
signature.asc
Description: Digital signature
