diff --git a/docs/promises/combinators.md b/docs/promises/combinators.md
index a6fcca6..ce0c7d0 100644
--- a/docs/promises/combinators.md
+++ b/docs/promises/combinators.md
@@ -33,7 +33,8 @@ Loop::run(function () {
 
     try {
         // magic combinator sauce to flatten the promise
-        // array into a single promise
+        // array into a single promise.
+        // yielding an array is an implicit "yield Amp\Promise\all($array)".
         $responses = yield array_map(function ($uri) use ($httpClient) {
             return $httpClient->request($uri);
         }, $uris);