From 3dbe21a480f663acc90ca92ee66f1b657966f29c Mon Sep 17 00:00:00 2001
From: "Alex A. Naanou" <alex.nanou@gmail.com>
Date: Sun, 2 May 2021 02:33:03 +0300
Subject: [PATCH] docs...

Signed-off-by: Alex A. Naanou <alex.nanou@gmail.com>
---
 README.md | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 9dad9bf..69a7b3e 100644
--- a/README.md
+++ b/README.md
@@ -1423,15 +1423,24 @@ Promise.iter(<array>)
 
 #### `<promise-iter>.map(..)` / `<promise-iter>.filter(..)` / `<promise-iter>.reduce(..)`
 
-
+Methods similar but not fully equivalent to `Array`'s 
+[`.map(..)`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/map), 
+[`.filter(..)`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/filter),
+and [`.reduce(..)`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/reduce)
 ```bnf
 <promise-iter>.map(<handler>)
     -> <promise-iter>
 
+<handler>(<elem>)
+    -> <elem>
+```
+
+```bnf
 <promise-iter>.filter(<handler>)
     -> <promise-iter>
 
 <handler>(<elem>)
+    -> <bool>
 ```
 
 ```bnf
@@ -1439,6 +1448,7 @@ Promise.iter(<array>)
     -> <promise-iter>
 
 <handler>(<state>, <elem>)
+    -> <state>
 ```
 
 Note that these are different to `Array`'s equivalents in some details: