review documentation

proof read of the documentation to fix minor typos etc.
not all files were reviewed at this time.
for issue #2048
With reStructuredText, the underlines denoting sections, subsections, etc... must match exactly the title's length.
Since there's one more letter in the title, another '=' just below the title is needed.