pg.ddx.io  pgsql-docs@postgresql.org mailing list archive  
help / color / mirror / Atom feed
Code example not following convention
2+ messages / 2 participants
[nested] [flat]

* Code example not following convention
@ 2022-11-19 19:36  PG Doc comments form <noreply@postgresql.org>
  0 siblings, 1 reply; 2+ messages in thread

From: PG Doc comments form @ 2022-11-19 19:36 UTC (permalink / raw)
  To: pgsql-docs@lists.postgresql.org; +Cc: kinanrod@gmail.com

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.


^ permalink  raw  reply  [nested|flat] 2+ messages in thread

* Re: Code example not following convention
@ 2022-11-19 22:35  David G. Johnston <david.g.johnston@gmail.com>
  parent: PG Doc comments form <noreply@postgresql.org>
  0 siblings, 0 replies; 2+ messages in thread

From: David G. Johnston @ 2022-11-19 22:35 UTC (permalink / raw)
  To: kinanrod@gmail.com; pgsql-docs@lists.postgresql.org

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.

^ permalink  raw  reply  [nested|flat] 2+ messages in thread


end of thread, other threads:[~2022-11-19 22:35 UTC | newest]

Thread overview: 2+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2022-11-19 19:36 Code example not following convention PG Doc comments form <noreply@postgresql.org>
2022-11-19 22:35 ` David G. Johnston <david.g.johnston@gmail.com>

This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox