(#848) - Update docs with promise info.