more documentation and cleaning updates