(yardoc) Improve munge/unmunge documentation.

The doc described implementation in the summary as opposed to the
intent. Less useful when referencing the documentation from elsewhere.
(yardoc) Complete the yardoc of Puppet::Property.

This completes the first round of documentation for Puppet::Property.
Many questions still unanswered.