docs($promises): update promise-related documentation closes #910
[skip ci]