update a few docs and comments