Language style fixes, fix broken links, markup nits, and typos.

Motivated from a patch in the PR, but the patch itself had a number
of issues and there were mahy other things that needed fixing.

PR: 32818
Submitted by: Hiten Pandya <hiten@uk.FreeBSD.org>