(docs) Cleanup inline docs

Mostly formatting and style changes here since we now generate the core facts documentation directly from the source.
Yup, even though I violated it in the first version of this PR (fixed now).

The basic rule is that products are capitalized, but executables and features are not.