Re: BUG #17446: Suggest updating the section title "Building Indexes Concurrently" - Mailing list pgsql-bugs

From David G. Johnston
Subject Re: BUG #17446: Suggest updating the section title "Building Indexes Concurrently"
Date
Msg-id CAKFQuwaMhJXP1_n_-KfrjvqCJtG_M0NSqMCOxEQQqYhVoQZpoA@mail.gmail.com
Whole thread Raw
In response to BUG #17446: Suggest updating the section title "Building Indexes Concurrently"  (PG Bug reporting form <noreply@postgresql.org>)
List pgsql-bugs
On Tue, Mar 22, 2022 at 4:19 PM PG Bug reporting form <noreply@postgresql.org> wrote:
The following bug has been logged on the website:

Bug reference:      17446
Logged by:          Troy Frericks
Email address:      troy@frericks.us
PostgreSQL version: 10.17
Operating system:   Documentation suggestion, ambiguous
Description:       

https://www.postgresql.org/docs/9.6/sql-createindex.html#SQL-CREATEINDEX-CONCURRENTLY

Suggest changing section title "Building Indexes Concurrently" to "Building
Indexes Using the CONCURRENTLY Parameter" to eliminate any ambiguity.

That seems worse.  If anything the title should answer the question "Concurrent with What?".  Right now one infers it means with other read/write activity on the table - as opposed to, say, additional indexing operations on different connections, which may or may not touch the same tables.  This is the concept of concurrency we want to refer to here - the parameter has already been described above.

David J.

pgsql-bugs by date:

Previous
From: Michael Paquier
Date:
Subject: Re: BUG #17441: shm_mq receive less data than the sender sends
Next
From: Masahiko Sawada
Date:
Subject: Re: BUG #17385: "RESET transaction_isolation" inside serializable transaction causes Assert at the transaction end