clean up code docs
clean up constructor
reword intro
clean up intro examples