update docs with promise info