docs and fixes