more docs and fixes