(docs) Cleanup inline docs

Mostly formatting and style changes here since we now generate the core facts documentation directly from the source.
Do you have a guideline for when you capitalize 'puppet' and 'facter'?