docs and fixes to package.json