Code example not following convention

Started by PG Bug reporting formover 3 years ago2 messagesdocs
Jump to latest
#1PG Bug reporting form
noreply@postgresql.org

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.

#2David G. Johnston
david.g.johnston@gmail.com
In reply to: PG Bug reporting form (#1)
Re: Code example not following convention

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.