tweak README
update type documentation