some docs and some cleanup