Message-ID: <7344373b30cd07a97cc490b29ed4f93fc90da43c.camel@cybertec.at>
Subject: Re: New docs chapter on Transaction Management and related changes
From: Laurenz Albe <laurenz.albe@cybertec.at>
To: Simon Riggs <simon.riggs@enterprisedb.com>
Cc: Bruce Momjian <bruce@momjian.us>, Robert Treat <rob@xzilla.net>, Alvaro
 Herrera <alvherre@alvh.no-ip.org>, Erik Rijkers <er@xs4all.nl>, Justin
 Pryzby <pryzby@telsasoft.com>,  PostgreSQL Hackers
 <pgsql-hackers@postgresql.org>
Date: Tue, 08 Nov 2022 04:37:59 +0100
In-Reply-To: <3603e6e85544daa5300c7106c31bc52673711cd0.camel@cybertec.at>
References: <Y0iL7jzLfSbj1T38@momjian.us>
	 <20221014084615.chvollxv3oz43oqu@alvherre.pgsql>
	 <CANbhV-E287+hqhEbC7vCShT16LKYM8aUhrvxQZdjX2osKAETkQ@mail.gmail.com>
	 <Y0m9tIrlMqaA9dwP@momjian.us>
	 <CAJSLCQ32vZ8S+yFbO1bKbKT=JE8Q6oRJXeRqfN6Atk-XJKPr7g@mail.gmail.com>
	 <Y0tZf7N+cUJ9ebPI@momjian.us>
	 <80a5fd9c080d66e62f90c9565e3e1b54e61f584c.camel@cybertec.at>
	 <CANbhV-GafnnLmyMmjwYGFFcspk_twoEO56M3jiB7D0p_TkUmZA@mail.gmail.com>
	 <3603e6e85544daa5300c7106c31bc52673711cd0.camel@cybertec.at>
Content-Type: text/plain; charset="UTF-8"
User-Agent: Evolution 3.42.4 (3.42.4-2.fc35) 
MIME-Version: 1.0
Content-Transfer-Encoding: 8bit
Archived-At: 
 <https://www.postgresql.org/message-id/7344373b30cd07a97cc490b29ed4f93fc90da43c.camel%40cybertec.at>
Precedence: bulk

On Mon, 2022-11-07 at 23:04 +0100, Laurenz Albe wrote:
> On Sat, 2022-11-05 at 10:08 +0000, Simon Riggs wrote:
> > Agreed; new compilation patch attached, including mine and then
> > Robert's suggested rewordings.
> 
> Thanks.  There is clearly a lot of usefule information in this.
> 
> Some comments: [...]

I thought some more about the patch, and I don't like the title
"Transaction Management" for the new chapter.  I'd expect some more
from a chapter titled "Internals" / "Transaction Management".

In reality, the new chapter is about transaction IDs.  So perhaps the
name should reflect that, so that it does not mislead the reader.

Yours,
Laurenz Albe