DOCS - Clarify the publication 'publish_via_partition_root' default value.

Peter Smith <smithpb2250@gmail.com>

From: Peter Smith <smithpb2250@gmail.com>

To: PostgreSQL Hackers <pgsql-hackers@lists.postgresql.org>

Date: 2025-12-11T07:51:47Z

Lists: pgsql-hackers

Commits

Same data as JSON: GET /api/v1/messages/:b64id/commits the thread's linked commits as JSON, with link sources. API reference →

doc: Improve description of publish_via_partition_root
- e2aae8d68f6b 19 (unreleased) landed
- d2c6ff7c525b 18.2 landed
- 862f83f3aa40 17.8 landed
- b95bdde5119d 16.12 landed
- 988612c9c27f 15.16 landed
- 5f43df007485 14.21 landed

Hi,

When reading the docs for the publication parameter
'publish_via_partition_root' [1], I felt there was too much mental
gymnastics required to understand the meaning of "the latter is the
default."

Why not just say clearly what the default value is?

PSA: a patch to do that.

======
[1] https://www.postgresql.org/docs/current/sql-createpublication.html#SQL-CREATEPUBLICATION-PARAMS-WITH-PUBLISH-VIA-PARTITION-ROOT

Kind Regards,
Peter Smith.
Fujitsu Australia