update documentation to use gender neutral pronouns where applicable (closes #1283)

and fix some typos along the way
8 files changed