| From: | Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> |
|---|---|
| To: | Bruce Momjian <bruce(at)momjian(dot)us> |
| Cc: | "David G(dot) Johnston" <david(dot)g(dot)johnston(at)gmail(dot)com>, "raspreet800(at)gmail(dot)com" <raspreet800(at)gmail(dot)com>, "pgsql-docs(at)lists(dot)postgresql(dot)org" <pgsql-docs(at)lists(dot)postgresql(dot)org> |
| Subject: | Re: Duplicate paragraph |
| Date: | 2021-05-25 13:55:02 |
| Message-ID: | 1208248.1621950902@sss.pgh.pa.us |
| Views: | Raw Message | Whole Thread | Download mbox | Resend email |
| Thread: | |
| Lists: | pgsql-docs |
Bruce Momjian <bruce(at)momjian(dot)us> writes:
> On Mon, May 24, 2021 at 09:35:49PM -0700, David G. Johnston wrote:
>> They are two different things, as evidenced by there being two different
>> sections with different section headings, that use the same fundamental writing
>> rules.
> We have gotten reports about this perceived duplication before --- not
> sure how we can improve things.
Yeah, I was just thinking the same. The rules *are* largely the same,
by design, so the text is necessarily going to be pretty similar.
But merging these sections doesn't sound like an improvement.
One thing we could easily do is not use isomorphic examples in the two
sections. For example, instead of illustrating how to spell "data" in
both forms, use "name" as the example for the identifier case.
regards, tom lane
| From | Date | Subject | |
|---|---|---|---|
| Next Message | David G. Johnston | 2021-05-25 14:13:09 | Re: Duplicate paragraph |
| Previous Message | David G. Johnston | 2021-05-25 13:47:04 | Re: Duplicate paragraph |