a few more docs and one update