review documentation

proof read of the documentation to fix minor typos etc.
not all files were reviewed at this time.
for issue #2048
"mutualize" looks actually better. or "factor out".
Creating helper methods is not exactly standardization.