From: Michael Paquier <michael@paquier.xyz>
To: Dave Cramer <davecramer@postgres.rocks>
Cc: first.sheemon@gmail.com
Cc: pgsql-docs@lists.postgresql.org
Subject: Re: Improve This Sentence?
Date: Fri, 24 Apr 2020 17:18:17 +0900
Message-ID: <20200424081817.GA1073623@paquier.xyz> (raw)
In-Reply-To: <CADK3HHK-w1TrfuWXcy4qFr9NxuiUcYoHRY__vhoH5qtDYcChJg@mail.gmail.com>
References: <158654352583.25698.11991707283132945859@wrigleys.postgresql.org>
<20200413005729.GC2169@paquier.xyz>
<CADK3HHK-w1TrfuWXcy4qFr9NxuiUcYoHRY__vhoH5qtDYcChJg@mail.gmail.com>
On Mon, Apr 13, 2020 at 05:54:26AM -0400, Dave Cramer wrote:
> Ironically the first one above is supposed to be providing more clarity if
> you can believe:
> For additional information on tuning these settings, see Section 29.4.
>
> Clearly just copying the text from 19.5.2 to 29.4 is an improvement. I'd be
> somewhat loathe to be that repetitive but honestly I don't have a better
> suggestion
Duplication is not good in my opinion, as updating one section may
cause the other to become outdated. As the performance issues are
mainly discussed in wal.sgml, why not moving the performance arguments
in the description of checkpoint_flush_after in config.sgml to
wal.sgml, and adding a link in config.sgml back to wal-configuration?
--
Michael
Attachments:
signature.asc (application/pgp-signature, 832B) download
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: pgsql-docs@postgresql.org
Cc: michael@paquier.xyz, davecramer@postgres.rocks, first.sheemon@gmail.com, pgsql-docs@lists.postgresql.org
Subject: Re: Improve This Sentence?
In-Reply-To: <20200424081817.GA1073623@paquier.xyz>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox