Added more documentation for the new Promise API.