[PATCH] Attempt to clarify example of serialization anomaly

From: Will Mortensen <will(at)extrahop(dot)com>
To: pgsql-docs(at)lists(dot)postgresql(dot)org
Cc: "laurenz(dot)albe(at)cybertec(dot)at" <laurenz(dot)albe(at)cybertec(dot)at>, "David(dot)G(dot)Johnston(at)gmail(dot)com" <David(dot)G(dot)Johnston(at)gmail(dot)com>, "ej(at)evanjones(dot)ca" <ej(at)evanjones(dot)ca>, "hlinnaka(at)iki(dot)fi" <hlinnaka(at)iki(dot)fi>, "chris(dot)travers(at)gmail(dot)com" <chris(dot)travers(at)gmail(dot)com>
Subject: [PATCH] Attempt to clarify example of serialization anomaly
Date: 2022-12-29 00:44:37
Message-ID: CAMpnoC4x3ZbMC4eP6g10HJTuGDa_74fUpWao28+af-suN08rPg@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

(sorry to the CCs for sending this twice)

This example has been pointed out as confusing in multiple places, e.g.:

* https://postgrespro.com/list/thread-id/1845118
* https://dba.stackexchange.com/a/43951
* https://stackoverflow.com/a/50733640 ("this paragraph is dark")

As mentioned in those links, it seems to attempt to summarize the
wiki's example at https://wiki.postgresql.org/wiki/SSI#Deposit_Report
. I'm not sure if/how to link to the wiki from the docs, so here is my
humble attempt to summarize it concisely and (hopefully) clearly.

Alternatively, this example could be removed in favor of a reference
to the Serializable section and its example.

Attachment Content-Type Size
0004-doc-clarify-example-of-serialization-anomaly.patch.txt text/plain 3.4 KB

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Will Mortensen 2022-12-29 00:48:39 [PATCH] discuss interaction between functions and Read Committed
Previous Message Will Mortensen 2022-12-29 00:02:58 [PATCH] two minor fixes to MVCC docs