Re: New docs chapter on Transaction Management and related changes

Op 13-10-2022 om 23:28 schreef Bruce Momjian:
> On Tue, Sep 13, 2022 at 03:02:34PM +0100, Simon Riggs wrote:
>> Thanks Robert. I've tried to accommodate all of your thoughts, plus Alvaro's.
>>
>> New v5 attached.
>>
>> Happy to receive further comments.
> 
> I liked this patch very much.  It gives details on a lot of the
> internals we expose to users.  Some of my changes were:
> 
> *  tightening the wording
> *  restructuring the flow
> *  splitting out user-visible details (prepared transactions) from
>     internals, e.g., xid, vxid, subtransactions
> *  adding references from places in our docs to these new sections

> [xact.diff]

I think that
   'This chapter explains how the control the reliability of'

should be:
'This chapter explains how to control the reliability of'


And in these lines:
+   together in a transactional manner.  The commands <command>PREPARE
+   TRANSACTION</command>, <command>COMMIT PREPARED</command> and
+   <command>ROLLBACK PREPARED</command>.  Two-phase transactions

'The commands'

should be
'The commands are'


thanks,

Erik Rijkers


> I plan to apply this and backpatch it to all supported versions since
> these details apply to all versions.  These docs should enable our users
> to much better understand and monitor Postgres.
> 
> Updated patch attached.