From: Tom Lane <tgl@sss.pgh.pa.us>
To: Alvaro Herrera <alvherre@alvh.no-ip.org>
cc: Bruce Momjian <bruce@momjian.us>,
        Peter Eisentraut <peter.eisentraut@enterprisedb.com>,
        Laurenz Albe <laurenz.albe@cybertec.at>,
        Simon Riggs <simon.riggs@enterprisedb.com>,
        Robert Treat <rob@xzilla.net>, Erik Rijkers <er@xs4all.nl>,
        Justin Pryzby <pryzby@telsasoft.com>,
        PostgreSQL Hackers <pgsql-hackers@postgresql.org>
Subject: Re: New docs chapter on Transaction Management and related changes
In-reply-to: <20221130172022.yxtohqbzvosa4f7g@alvherre.pgsql>
References: <20221130172022.yxtohqbzvosa4f7g@alvherre.pgsql>
Comments: In-reply-to Alvaro Herrera <alvherre@alvh.no-ip.org>
	message dated "Wed, 30 Nov 2022 18:20:22 +0100"
MIME-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-ID: <1360528.1669829515.1@sss.pgh.pa.us>
Date: Wed, 30 Nov 2022 12:31:55 -0500
Message-ID: <1360529.1669829515@sss.pgh.pa.us>
Archived-At: 
 <https://www.postgresql.org/message-id/1360529.1669829515%40sss.pgh.pa.us>
Precedence: bulk

Alvaro Herrera <alvherre@alvh.no-ip.org> writes:
> I find it a bit shocking to have had it backpatched, even to 15 -- a
> whole chapter in the documentation?  I don't see why it wouldn't be
> treated like any other "major feature" patch, which we only consider for
> the development branch.  Also, this is a first cut -- presumably we'll
> want to copy-edit it before it becomes released material.

I think that last point is fairly convincing.  I've not read the
new material, but I didn't get further than the first line of
the new chapter file before noting a copy-and-paste error:

--- /dev/null
+++ b/doc/src/sgml/xact.sgml
@@ -0,0 +1,205 @@
+<!-- doc/src/sgml/mvcc.sgml -->

That doesn't leave me with a warm feeling that it's ready to ship.
I too vote for reverting it out of the released branches.

			regards, tom lane