From aedc9f0e7f27c0fd3ab18a0c6cdb93e7030e87bc Mon Sep 17 00:00:00 2001
From: "Alex A. Naanou" <alex.nanou@gmail.com>
Date: Sat, 10 Oct 2020 17:27:00 +0300
Subject: [PATCH] docs...

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

diff --git a/README.md b/README.md
index 7264b2a..3222358 100644
--- a/README.md
+++ b/README.md
@@ -317,16 +317,24 @@ This will return `true` if:
 
 #### `<array>.inplaceSortAs(..)`
 
+#### `<array>.toKeys(..)`
+
+#### `<array>.toMap(..)`
+
+
+### Large `Array` iteration (chunked)
+
+Iterating over very large `Array` instances in JavaScript can block execution,
+to avoid this `types.js` implements `.map(..)`/`.filter(..)`/`.reduce(..)`
+equivalent methods that split the array into chunks and iterate through
+them asynchroniosly giving the runtime a chance to run in between.
+
 #### `<array>.mapChunks(..)`
 
 #### `<array>.filterChunks(..)`
 
 #### `<array>.reduceChunks(..)`
 
-#### `<array>.toKeys(..)`
-
-#### `<array>.toMap(..)`
-
 
 ### `Array` (polyfill)