more docs and more fixes