From 847757c28b7065ea35d1915f787e302295cea15c Mon Sep 17 00:00:00 2001
From: carlosganzerla <carlosganzrl@hotmail.com>
Date: Tue, 28 Oct 2025 12:39:05 -0300
Subject: [PATCH v1] doc: added addendum to GEQO GUC documentation

Added an addendum which implies that GEQO may not always improve
planning performance and by consequence that also may harm performance
in some scenarios. The specific scenarios are out of scope here.
---
 doc/src/sgml/config.sgml | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/doc/src/sgml/config.sgml b/doc/src/sgml/config.sgml
index 0a2a8b49fdb..a89f75230d2 100644
--- a/doc/src/sgml/config.sgml
+++ b/doc/src/sgml/config.sgml
@@ -6190,9 +6190,9 @@ ANY <replaceable class="parameter">num_sync</replaceable> ( <replaceable class="
 
      <para>
       The genetic query optimizer (GEQO) is an algorithm that does query
-      planning using heuristic searching.  This reduces planning time for
-      complex queries (those joining many relations), at the cost of producing
-      plans that are sometimes inferior to those found by the normal
+      planning using heuristic searching. This usually reduces planning time
+      for complex queries (those joining many relations), at the cost of
+      producing plans that are sometimes inferior to those found by the normal
       exhaustive-search algorithm.
       For more information see <xref linkend="geqo"/>.
      </para>
@@ -6216,8 +6216,9 @@ ANY <replaceable class="parameter">num_sync</replaceable> ( <replaceable class="
        <para>
         Enables or disables genetic query optimization.
         This is on by default.  It is usually best not to turn it off in
-        production; the <varname>geqo_threshold</varname> variable provides
-        more granular control of GEQO.
+        production. However, keep in mind that GEQO may not always produce
+        faster plans in every scenario; the <varname>geqo_threshold</varname>
+        variable provides more granular control of GEQO.
        </para>
       </listitem>
      </varlistentry>
-- 
2.51.1