add repository to package.json
spruce up package metadata
Fix typos, improve code snippets, and add info about running tests to the README