Re: Typo in 15.3.4

From: "David G(dot) Johnston" <david(dot)g(dot)johnston(at)gmail(dot)com>
To: Daniel Gustafsson <daniel(at)yesql(dot)se>
Cc: grantgryczan(at)gmail(dot)com, pgsql-docs(at)lists(dot)postgresql(dot)org
Subject: Re: Typo in 15.3.4
Date: 2024-07-29 14:13:50
Message-ID: CAKFQuwZ-GS4=A7mSRAaRBx1ozjy2j5B7TXKaeZcAXsNq81TWoA@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

On Mon, Jul 29, 2024 at 7:00 AM Daniel Gustafsson <daniel(at)yesql(dot)se> wrote:

> On 25 Jul 2024, at 19:07, David G. Johnston <david(dot)g(dot)johnston(at)gmail(dot)com>
> wrote:
>
> On Thu, Jul 25, 2024 at 9:50 AM PG Doc comments form <
> noreply(at)postgresql(dot)org> wrote:
>
>> The following documentation comment has been logged on the website:
>>
>> Page: https://www.postgresql.org/docs/16/parallel-plans.html
>> Description:
>>
>> In section 15.3.4, I believe "multiple results sets" is a typo for
>> "multiple
>> result sets". It says:
>>
>> > Plans that involve appending multiple results sets can therefore achieve
>> coarse-grained parallelism even when efficient partial plans are not
>> available.
>>
>> It's also possible this should say "multiple results" rather than
>> "multiple
>> result sets".
>
>
> Good catch, and an acceptable solution.
>
> However, I'm inclined to write: "multiple inputs" at that spot:
>
> Plans that involve appending multiple inputs can therefore achieve...
>
> Using the term "result set" here just feels off, though that is a mostly
> uninformed (as to precedent) opinion.
>
>
> I think result sets the correct term since the Append node is combining
> partial
> results made by other parallel nodes. Doing some reading it seems to me
> that
> "results sets" isn't incorrect (though I might have misunderstood the
> grammar
> from not being a native speaker), but I'm still inclined to change since we
> consistently use "result sets" in the rest of the documentation.
>
>
Yes, if we leave the term "result set" in place the trailing "s" in the
existing "results" needs to go. I was referring to the term as a whole
when I said it "feels off", not that the spelling of "result sets" is wrong.

David J.

In response to

Browse pgsql-docs by date

  From Date Subject
Next Message Tom Lane 2024-07-29 14:58:06 Re: incorrect (incomplete) description for "alter domain"
Previous Message Daniel Gustafsson 2024-07-29 14:00:00 Re: Typo in 15.3.4