typo
remove repetition; improve readability
Merge pull request #973 from tshepang/better

some doc improvements