Updating promise doc with small changes

Just some small tweaks I found when reviewing the promises doc.