making readability changes and grammar fixes
fix errors reported by sphinx