diff --git a/README.md b/README.md
index 1acfc53a54e..99366915d6f 100644
--- a/README.md
+++ b/README.md
@@ -113,7 +113,7 @@ try {
 
 ```
 
-> Note: The SDK is designed to make async requests by default, to get the result object add `wait()` after the operation.
+> Note: The SDK is designed to make async requests by default. Operations (`get()`, `post()`...) return a [Promise](https://docs.php-http.org/en/latest/components/promise.html). To get the result, call `wait()` after the operation.
 > Example: `->get()->wait();`
 
 Note that to calling `me()` requires a signed-in user and therefore delegated permissions (obtained using the `authorization_code` flow):