fill in readme, fix package.json, enhance parsing