more documentation fixes and clean up