Task/review documentation

Review and update the documentation.
Colons in the headers of tables in Markdown are used to signal how the text should be aligned.

NTC