Re: Improve examples: Provide the example which extend to the left of the range - Mailing list pgsql-docs

From David G. Johnston
Subject Re: Improve examples: Provide the example which extend to the left of the range
Date
Msg-id CAKFQuwYch-sZyjNbXY9f=0WFL_E=hHBkJoFY0mV6WoD965Zxfg@mail.gmail.com
Whole thread Raw
List pgsql-docs
On Tue, Jan 21, 2025 at 10:09 AM PG Doc comments form <noreply@postgresql.org> wrote:
The following documentation comment has been logged on the website:

Page: https://www.postgresql.org/docs/17/functions-range.html
Description:

It would be nice to have examples which `extend to the other range`. Eg. the
first example shows how to not extend, the second shows how to extend. Or
`range` examples shows how to not extend left/right, and the `multirange`
examples shows how to extend to the left/right.


The use of the word "how" here might just be a translation thing but to be sure this isn't about an action, it is strictly about whether the lower bound of the left argument is greater or less than the lower bound of the right argument.

I'll agree that all of this takes some thinking to understand but I don't know that simply adding examples that return false instead of true is a big gain.

Maybe reword it, removing the "not"?

Thus:

Does the first range not extend to the left of the second?

Becomes:

Is the lower bound of the first range larger than or equal to the lower bound of the second range?

David J.

pgsql-docs by date:

Previous
From: "David G. Johnston"
Date:
Subject: Re: Text correction
Next
From: "David G. Johnston"
Date:
Subject: Re: substring synopsis section, third argument is optional doc didn't show that