Thread: Code example not following convention

Code example not following convention

From
PG Doc comments form
Date:
The following documentation comment has been logged on the website:

Page: https://www.postgresql.org/docs/15/tutorial-window.html
Description:

in:
https://www.postgresql.org/docs/current/tutorial-window.html
The example involving the RANK() function displays it in lower-case, which
is misleading for new users.

Re: Code example not following convention

From
"David G. Johnston"
Date:
On Sat, Nov 19, 2022 at 2:55 PM PG Doc comments form <noreply@postgresql.org> wrote:
The following documentation comment has been logged on the website:

Page: https://www.postgresql.org/docs/15/tutorial-window.html
Description:

in:
https://www.postgresql.org/docs/current/tutorial-window.html
The example involving the RANK() function displays it in lower-case, which
is misleading for new users.

There is nothing wrong with those examples and no convention that suggests rank() needs to be upper-case.  You'll need to be more specific if you feel otherwise - pointing out either the convention as described or at least some supporting examples.

What were you misled into believing by seeing rank() in lower-case?

David J.