various fixes
docs and fixes