Re: Duplicate paragraph

From: "David G(dot) Johnston" <david(dot)g(dot)johnston(at)gmail(dot)com>
To: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
Cc: Bruce Momjian <bruce(at)momjian(dot)us>, "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 14:13:09
Message-ID: CAKFQuwa5Y9XyeHM+21m6CK9VEeg6aNd0FxbX+VdWvjscDkrSgw@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

On Tuesday, May 25, 2021, Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> wrote:

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

Agrreed.

>
> 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.
>
>
+1. This is the kind change I expected to find once I started looking for
specifics.

David J.

In response to

Browse pgsql-docs by date

  From Date Subject
Next Message tanghy.fnst@fujitsu.com 2021-05-26 02:39:50 RE: pg_type_d.h location incorrect
Previous Message Tom Lane 2021-05-25 13:55:02 Re: Duplicate paragraph