various improvements
remove redundant text
Merge pull request #67 from tshepang/patch-2

various doc improvements