read proof documentation

[acatl]

Problem description:

Have the team read-proof our new documentation.

• [ ] fix small grammatical issues
• [ ] fix small re-wording of descriptions
• [ ] create new issues to suggest additions or big changes