improve docs and improve package.json