(#21881) Add documentation for Puppet::Indirection::ResourceType::Parser

This clarifies the use of this indirection somewhat and conforms better to
YARD syntax.