first pass review (#673)

* first pass review

* incorporated review comments

* remove release notes section

* incorporate revew comments

* incorporate debugging comments

* incorporate Lenny's example

* create TOC

* fix TOC

* move example code

* re-fix TOC

Author: rosemarymarano