public inbox for [email protected]  
help / color / mirror / Atom feed
From: David G. Johnston <[email protected]>
To: Tom Lane <[email protected]>
Cc: Bruce Momjian <[email protected]>
Cc: [email protected] <[email protected]>
Cc: [email protected] <[email protected]>
Subject: Re: Duplicate paragraph
Date: Tue, 25 May 2021 07:13:09 -0700
Message-ID: <CAKFQuwa5Y9XyeHM+21m6CK9VEeg6aNd0FxbX+VdWvjscDkrSgw@mail.gmail.com> (raw)
In-Reply-To: <[email protected]>
References: <[email protected]>
	<CAKFQuwZ2PLVxaO3xuk=L0hwhQpfP4zLSGf6GbFXTikDfW5-SQA@mail.gmail.com>
	<[email protected]>
	<[email protected]>

On Tuesday, May 25, 2021, Tom Lane <[email protected]> wrote:

> Bruce Momjian <[email protected]> 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.


reply

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: [email protected]
  Cc: [email protected], [email protected], [email protected], [email protected], [email protected]
  Subject: Re: Duplicate paragraph
  In-Reply-To: <CAKFQuwa5Y9XyeHM+21m6CK9VEeg6aNd0FxbX+VdWvjscDkrSgw@mail.gmail.com>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox