mypy

aaa2685a - Various small documentation updates (#11817)

Various small documentation updates (#11817) Improve consistency, grammar, formatting and clarity in the documentation. Also some minor content fixes.