Re: Documentation improvement patch

Daniel Gustafsson <daniel@yesql.se>

From: Daniel Gustafsson <daniel@yesql.se>
To: Peter Eisentraut <peter@eisentraut.org>
Cc: Oleg <o.sibiryakov@postgrespro.ru>, pgsql-docs@lists.postgresql.org
Date: 2025-11-14T09:04:03Z
Lists: pgsql-docs

Attachments

> On 30 Oct 2025, at 11:15, Peter Eisentraut <peter@eisentraut.org> wrote:

> -       Change the definition of a replication slot.
> +       Changes the definition of a replication slot.
> 
> I think these are intentionally written in imperative style.  Compare the synopses of the main SQL commands: "change the definition of a domain" etc.

I agree, I too think these are intentionally written like this.  The document
isn't entirely consistent and does mix style quite a bit but I don't think
these changes change the needle enough to make.

Attached is a v3 with the remaining changes and a stab at commit message that I
think we should go ahead with.

--
Daniel Gustafsson

Commits

  1. doc: Assorted documentation improvements