(maint) Explain a dead variable in puppet/util/docs.rb

I'm not sure what this was originally intended to do, but since we're hoping
this entire area of code won't exist in a year, I don't think it's worth more
action than leaving a note.
(#22432) Sort defaults/commands/features in provider doc hooks

Because hashes are unordered in Ruby, these lists would churn around randomly
each time you generated the references, making it harder to mechanically compare
two versions of the type reference. Also, if the list is long and you're
actually looking for something in it, that would make it harder to scan. So
let's sort the arrays returned by these collect calls!
Merge pull request #1877 from nfagerlund/typeref_tweaks

Sort defaults/commands/features in provider doc hooks