some docs and cleanup