first rewrite
updating docs and comments
updating docs
updated docs
updated docs
updated docs
updated docs
Merge branch 'rewriting-docs'