Documentation: Minor typo fixes. Some readability changes

[MikeColes]

Improve documentation.

What does this PR do?

Minor typo fixes. Some readability changes. No technical changes.

Checklist before merging

• [na ] All top level messages commented
• [na ] All enum members have unique descriptions