some docs and cleanup
polish and docs