From: PG Doc comments form <noreply@postgresql.org>
To: pgsql-docs@lists.postgresql.org
Cc: wolakk@gmail.com
Subject: First Person being used (only occurs in 2 other places in all of documentation)
Date: Fri, 28 Oct 2022 02:44:44 +0000
Message-ID: <166692508416.630.9910522387468316027@wrigleys.postgresql.org> (raw)
The following documentation comment has been logged on the website:
Page: https://www.postgresql.org/docs/15/cube.html
Description:
I believe the use of First Person (I) is to be avoided in the documentation.
It is incredibly rare in all of the documentation.
This is a NUANCE issue, but so are white space comments in code!
I will paste in what is written => what is suggested (fix as you wish)
On this page:
F.9.4. Defaults
I believe this union: => This union:
Below that:
... I assume the ... => ... one can assume the ...
F.9.6. Credits
>> Note that changing the credits someone is giving might be pushing it, but
again, it does not exist like this elsewhere!
I am also grateful to all Postgres ... => With gratitude to all Postgres
...
And I would like to acknowledge my gratitude to Argonne ... => With further
gratitude to Argonne ...
[I will add a separate comment for the other 2 occurrences]
Thanks in advance!
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: pgsql-docs@postgresql.org
Cc: noreply@postgresql.org, pgsql-docs@lists.postgresql.org, wolakk@gmail.com
Subject: Re: First Person being used (only occurs in 2 other places in all of documentation)
In-Reply-To: <166692508416.630.9910522387468316027@wrigleys.postgresql.org>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
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