Simplify and standardize the text, and split up
the docs sections to fix an anchor issue.

Changelog: changed