updates to docs and some code