docs updates

bring it up to date with your promise use.