Re: Code example not following convention - Mailing list pgsql-docs

From David G. Johnston
Subject Re: Code example not following convention
Date
Msg-id CAKFQuwZJaoiSszhX5dgMsOuMDkUV4YHEX--bap=mPpRVWL=BjA@mail.gmail.com
Whole thread Raw
In response to Code example not following convention  (PG Doc comments form <noreply@postgresql.org>)
List pgsql-docs
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.

pgsql-docs by date:

Previous
From: PG Doc comments form
Date:
Subject: Code example not following convention
Next
From: Guillaume Lelarge
Date:
Subject: Doc fix