From a49c874de53b232e67e9e7f13fc305b3a6e5646e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Benedikt=20R=C3=B6tsch?= <opensource@axe312.dev>
Date: Mon, 29 Mar 2021 13:47:21 +0200
Subject: [PATCH] docs: add comment about page-limit backoff logic

---
 packages/gatsby-source-contentful/src/fetch.js | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/gatsby-source-contentful/src/fetch.js b/packages/gatsby-source-contentful/src/fetch.js
index a47a085f24918..a42e6d55ab456 100644
--- a/packages/gatsby-source-contentful/src/fetch.js
+++ b/packages/gatsby-source-contentful/src/fetch.js
@@ -226,6 +226,8 @@ ${formatPluginOptionsForCLI(pluginConfig.getOriginalPluginOptions(), errors)}`,
           currentPageLimit > 1
         ) {
           lastCurrentPageLimit = currentPageLimit
+          // Reduce page limit by a arbitrary 1/3 of the current limit to ensure
+          // the new and bigger entries are synced without exceeding the reponse size limit
           currentPageLimit = Math.floor((currentPageLimit / 3) * 2) || 1
           reporter.warn(
             [