Re: doc: Bring mention of unique index forced transaction wait behavior outside of the internal section - Mailing list pgsql-hackers

From Aleksander Alekseev
Subject Re: doc: Bring mention of unique index forced transaction wait behavior outside of the internal section
Date
Msg-id CAJ7c6TPDBaaHPgmj5bs89GofubKArbDBP+GnT=Gc4FO16q4-WQ@mail.gmail.com
Whole thread Raw
In response to doc: Bring mention of unique index forced transaction wait behavior outside of the internal section  ("David G. Johnston" <david.g.johnston@gmail.com>)
Responses Re: doc: Bring mention of unique index forced transaction wait behavior outside of the internal section
List pgsql-hackers
Hi David,

> It's basically a glorified cross-reference.  I didn't dislike directing the reader to the internals section enough to
tryand establish a better location for the main content.
 

One problem I see is that:

+ [..], but as there is no pre-existing data, visibility checks are unnecessary.

... allows a wide variety of interpretations, most of which will be
wrong. And all in all I find an added paragraph somewhat cryptic.

If the goal is to add a cross-reference I suggest keeping it short,
something like "For additional details on various corner cases please
see ...".

-- 
Best regards,
Aleksander Alekseev



pgsql-hackers by date:

Previous
From: Przemysław Sztoch
Date:
Subject: Re: [PATCH] Completed unaccent dictionary with many missing characters
Next
From: Jakub Wartak
Date:
Subject: RE: Use fadvise in wal replay