Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: quoted-printable
Subject: Server configuration shot overview
To: pgsql-docs@lists.postgresql.org
From: PG Doc comments form <noreply@postgresql.org>
Cc: oli.sennhauser@fromdual.com
Reply-To: oli.sennhauser@fromdual.com, pgsql-docs@lists.postgresql.org
Date: Fri, 31 Jul 2026 09:38:35 +0000
Message-ID: <178549071520.2195443.221949298120586040@wrigleys.postgresql.org>
Auto-Submitted: auto-generated
Archived-At: 
 <https://www.postgresql.org/message-id/178549071520.2195443.221949298120586040%40wrigleys.postgresql.org>
Precedence: bulk

The following documentation comment has been logged on the website:

Page: https://www.postgresql.org/docs/18/runtime-config.html
Description:

When reading the configuration parameters
(https://www.postgresql.org/docs/current/runtime-config-wal.html) I found it
difficult to find fast the (for me) relevant information: What is the
default? When/how can it be changed? The information is/was always there but
somehow hidden in the text...

So I think it would be more convenient to have these informations summarized
in the beginning?

3 Examples:

synchronous_commit (enum)

--------------|----------
Context       | user
Default Value | on
Minimum Value | -
Maximum Value | -
Unit          | -
Valid Values  | remote_apply, on, remote_write, local, off

Specifies how much WAL processing must complete before...

https://www.postgresql.org/docs/current/runtime-config-wal.html#GUC-SYNCHRO=
NOUS-COMMIT

---

full_page_writes (boolean)

--------------|----------
Context       | sighup
Default Value | on
Minimum Value | -
Maximum Value | -
Unit          | -
Valid Values  | on, off

When this parameter is on, the PostgreSQL server...

https://www.postgresql.org/docs/current/runtime-config-wal.html#GUC-SYNCHRO=
NOUS-COMMIT

---

checkpoint_timeout (integer)

--------------|----------
Context       | sighup
Default Value | 300
Minimum Value | 30
Maximum Value | 86400
Unit          | s
Valid Values  | -

Maximum time between automatic WAL checkpoints...

https://www.postgresql.org/docs/current/runtime-config-wal.html#GUC-CHECKPO=
INT-TIMEOUT

---

What are other thinking about? Is it worth to take the effort and if yes how
should this be done? All the 400 settings at once (pouhh!) or section by
section?