tweak readme and docs