docs: Fix up doc highlights, indents and more

Also fix up EOL whitespace in some files.