some doc work and bounds checks
Merge branch 'p2' of github.com:drosen41/Stout into p2