docs: rm redundancy
docs: capitalise
docs: typos
Merge pull request #1157 from tshepang/diff

some doc fixes/improvements