| From: | Michael Paquier <michael(at)paquier(dot)xyz> |
|---|---|
| To: | Dave Cramer <davecramer(at)postgres(dot)rocks> |
| Cc: | first(dot)sheemon(at)gmail(dot)com, pgsql-docs(at)lists(dot)postgresql(dot)org |
| Subject: | Re: Improve This Sentence? |
| Date: | 2020-04-24 08:18:17 |
| Message-ID: | 20200424081817.GA1073623@paquier.xyz |
| Views: | Raw Message | Whole Thread | Download mbox | Resend email |
| Thread: | |
| Lists: | pgsql-docs |
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
| From | Date | Subject | |
|---|---|---|---|
| Next Message | Jonathan S. Katz | 2020-04-24 23:37:45 | Re: Documentation: 21.5. Default Roles |
| Previous Message | Олег Самойлов | 2020-04-24 00:47:13 | Re: explanation for random_page_cost is outdated |