Date: Fri, 24 Apr 2020 17:18:17 +0900
From: Michael Paquier <michael@paquier.xyz>
To: Dave Cramer <davecramer@postgres.rocks>
Cc: first.sheemon@gmail.com, pgsql-docs@lists.postgresql.org
Subject: Re: Improve This Sentence?
Message-ID: <20200424081817.GA1073623@paquier.xyz>
References: <158654352583.25698.11991707283132945859@wrigleys.postgresql.org>
 <20200413005729.GC2169@paquier.xyz>
 <CADK3HHK-w1TrfuWXcy4qFr9NxuiUcYoHRY__vhoH5qtDYcChJg@mail.gmail.com>
MIME-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha512;
	protocol="application/pgp-signature"; boundary="tKW2IUtsqtDRztdT"
Content-Disposition: inline
In-Reply-To: 
 <CADK3HHK-w1TrfuWXcy4qFr9NxuiUcYoHRY__vhoH5qtDYcChJg@mail.gmail.com>
Precedence: bulk


--tKW2IUtsqtDRztdT
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

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.
>=20
> 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

--tKW2IUtsqtDRztdT
Content-Type: application/pgp-signature; name="signature.asc"

-----BEGIN PGP SIGNATURE-----

iQIzBAABCgAdFiEEG72nH6vTowiyblFKnvQgOdbyQH0FAl6ioMkACgkQnvQgOdby
QH0KXhAAhiQhUKhPO2iw6x2RfFrNeRehuiwQrainh2MgMLe0pM9L0FjV/4SVA1Hr
k3kdIvDb1Fwk7e3tkd6LD/nfdcXN5Rzkc4x4B/mRcgIKtd5aH1LIynbnyW4fRZI7
sk+Xt52CNVguqr0nR6EIFZIuQvP1MnzqjW3pUNxT6ZufKwulcwJAFbRcS4TnVBm3
sMiMWzpjVoO2XypMACBWyF3ylngTYAsl0724l673HqEDs9NXnE7fX0ZY0bJoA03A
XunBtLyWeeq9Kl2mbw2sCFs9Q5FoWSpqqJfW4RGkKc0/3jnfM1HgqB6zYBKpgJYw
s34RRebnmvjSok+GOfbJhdUC6Lm2k1b2hzoGN6+yTXcstV62QTa4Of6doRgTQAOe
OoZW0n9tVx+On8PdvWQKjMNcfdKk3z8gRajZFZIurVoF5xV3ruMQA1hjSFO4Vzxw
SERE0svTWCW7hFBf9M+ucuu3mbaKgtjx2BQfPXrHbgdetssJObdZqtIPcSPxXeyi
GbeHwMLdZHilr0TbEjb5BXU4LUUUasmSU26zPyaWDSY478XF65aXAzn7dW91uX8I
RRoVUtTery+lOV4h/myPbOdYrOlnf8qP68DvzR3T70bfjLXGK4pKyrG2z+FaPAf4
EYXVpf4MYS5b0OXJovfiOz7mQQWhieeIAAvkkn8t5AqWQ5/0AT0=
=oOUT
-----END PGP SIGNATURE-----

--tKW2IUtsqtDRztdT--