tweaks to docs and readme