diff --git a/docs/configuration/pgdog.toml/databases.md b/docs/configuration/pgdog.toml/databases.md
index 4c420c9..5a71cb5 100644
--- a/docs/configuration/pgdog.toml/databases.md
+++ b/docs/configuration/pgdog.toml/databases.md
@@ -84,6 +84,9 @@ Default: **`0`**
 
 Overrides the [`default_pool_size`](general.md#default_pool_size) setting. All connection pools for this database will open at most this many connections to Postgres.
 
+!!! note "Recommendation"
+    We strongly recommend keeping this value well below the supported connections of the backend database(s) to allow connections for maintenance in high load scenarios.
+
 ### `statement_timeout`
 
 This setting configures the `statement_timeout` connection parameter on all connections to Postgres for this database.
diff --git a/docs/configuration/pgdog.toml/general.md b/docs/configuration/pgdog.toml/general.md
index 83a94c6..15a904b 100644
--- a/docs/configuration/pgdog.toml/general.md
+++ b/docs/configuration/pgdog.toml/general.md
@@ -38,6 +38,9 @@ Default: **`0`** (current thread runtime)
 
 Default maximum number of server connections per database pool. The pooler will not open more than this many PostgreSQL database connections when serving clients.
 
+!!! note "Recommendation"
+    We strongly recommend keeping this value well below the supported connections of the backend database(s) to allow connections for maintenance in high load scenarios.
+
 Default: **`10`**
 
 ### `min_pool_size`