Re: Improve "3.5. Window Functions" tutorial

From: "David G(dot) Johnston" <david(dot)g(dot)johnston(at)gmail(dot)com>
To: "matematica(dot)a3k(at)gmail(dot)com" <matematica(dot)a3k(at)gmail(dot)com>, "pgsql-docs(at)lists(dot)postgresql(dot)org" <pgsql-docs(at)lists(dot)postgresql(dot)org>
Subject: Re: Improve "3.5. Window Functions" tutorial
Date: 2026-10-02 06:40:09
Message-ID: CAKFQuwajCiVdPb5ecwStbaQeODYycrd33V1R3VgO8DU7geY0Kg@mail.gmail.com
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-docs

On Wednesday, September 30, 2026, 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/18/tutorial-window.html
> Description:
>
> Hi! I would like to propose improvements on the "3.5. Window Functions"
> tutorial.
>
> Wording may be improved ("scoped"), I think the added paragraph links the
> existing ones providing more meaning.
>

I’m in agreement with this page being in need of improvement. I’m not all
that comfortable with this particular proposal. It adds some of its own
concerns and doesn’t remove some existing ones.

As an aside - recent comments about the undesirability were made - and
while I’m accepting of their usage generally this one seems like a good
candidate for removal if we do update this page.

My biggest qualm is the wording that makes it sound like a window frame is
an option in lieu of looking at the partition when there is always some
default frame in place.

David J.

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message David G. Johnston 2026-10-02 06:56:32 Re: Improve "3.6. Inheritance" tutorial
Previous Message Matemática A3K 2026-10-01 19:14:16 Re: [Minor] Conflicting sentence in "2.4. Populating a Table With Rows"