update docs for v0.1.30

Author: levkk

docs/configuration/index.md

@@ -54,6 +54,16 @@ checkout_timeout = 5_000
 
 !!! note "TOML syntax"
     Since PgDog uses TOML, both `5000` and `5_000` are valid numbers. Configuration will fail to load if non-integer values are used, e.g. "5s" or "53.5".
+    
+## Overrides
+
+When reading the configuration files, PgDog will apply settings in the following order:
+
+1. Values in [`[[users]]`](users.toml/users.md) section take the highest priority
+2. Values in [`[[databases]]`](pgdog.toml/databases.md) are read next
+3. Values in [`[general]`](pgdog.toml/general.md) are used by default
+
+For example, if `pool_size` is set on a user, it will be used over the same setting on the database. If none is set on the user, but it is set on a database, that will take priority over `default_pool_size` configured in general settings.
 
 ## Overview
 

docs/configuration/pgdog.toml/databases.md

@@ -76,8 +76,8 @@ The shard number for this database. Only required if your database contains more
 
 Default: **`0`**
 
-!!! note
-    All settings below take priority over values in [`[general]`](general.md) and [`[[users]]`](../users.toml/users.md) config sections.
+!!! note "Settings priority"
+    All settings below take priority over values in [`[general]`](general.md).
 
 ### `pool_size`
 

docs/configuration/users.toml/users.md

@@ -36,6 +36,9 @@ The password for the user. Clients will need to provide this when connecting to
 
 Default: **none** (required)
 
+!!! note "Settings priority"
+    All settings below take priority over values in [`[general]`](../pgdog.toml/general.md) and [`[[databases]]`](../pgdog.toml/databases.md).
+
 ### `pool_size`
 
 Overrides [`default_pool_size`](../pgdog.toml/general.md) for this user. No more than this many server connections will be open at any given time to serve requests for this connection pool.