(docs) Cleanup inline docs

Mostly formatting and style changes here since we now generate the core
facts documentation directly from the source.