diff --git a/doc/configuration.txt b/doc/configuration.txt
index 7dbe4ca..450d831 100644
--- a/doc/configuration.txt
+++ b/doc/configuration.txt
@@ -2339,7 +2339,11 @@
   optimize the connection reuse rate. But to help with debugging or when
   suspecting a bug in HAProxy around connection reuse, it can be convenient to
   forcefully disable this idle pool sharing between multiple threads, and force
-  this option to "off". The default is on.
+  this option to "off". The default is on. It is strongly recommended against
+  disabling this option without setting a conservative value on "pool-low-conn"
+  for all servers relying on connection reuse to achieve a high performance
+  level, otherwise connections might be closed very often as the thread count
+  increases.
 
 tune.idletimer <timeout>
   Sets the duration after which haproxy will consider that an empty buffer is
@@ -14146,7 +14150,10 @@
   times. The default is zero, indicating that any idle connection can be used
   at any time. It is the recommended setting for normal use. This only applies
   to connections that can be shared according to the same principles as those
-  applying to "http-reuse".
+  applying to "http-reuse". In case connection sharing between threads would
+  be disabled via "tune.idle-pool.shared", it can become very important to use
+  this setting to make sure each thread always has a few connections, or the
+  connection reuse rate will decrease as thread count increases.
 
 pool-max-conn <max>
   Set the maximum number of idling connections for a server. -1 means unlimited