Update documentation to make returned promises clearer
Fix promise documentation