Use http://links.puppetlabs.com/ to create a link / short link and make it refer to whatever is the most recent documentation. Hardcoding links without indirection is not good. (This scheme is used for deprecations in
puppet core).  (Most recent example is this: See http://links.puppetlabs.com/puppet-mutation-deprecation - which I still had in my copy-paste buffer :-) ).