Re: Code example not following convention

From: "David G(dot) Johnston" <david(dot)g(dot)johnston(at)gmail(dot)com>
To: kinanrod(at)gmail(dot)com, pgsql-docs(at)lists(dot)postgresql(dot)org
Subject: Re: Code example not following convention
Date: 2022-11-19 22:35:02
Message-ID: CAKFQuwZJaoiSszhX5dgMsOuMDkUV4YHEX--bap=mPpRVWL=BjA@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

On Sat, Nov 19, 2022 at 2:55 PM 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/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.

In response to

Browse pgsql-docs by date

  From Date Subject
Next Message Guillaume Lelarge 2022-11-21 14:14:20 Doc fix
Previous Message PG Doc comments form 2022-11-19 19:36:53 Code example not following convention