Re: First Person being used (only occurs in 2 other places in all of documentation) - Mailing list pgsql-docs

From Daniel Gustafsson
Subject Re: First Person being used (only occurs in 2 other places in all of documentation)
Date
Msg-id 7CFAD02E-28A2-4383-8162-200667F7772D@yesql.se
Whole thread Raw
In response to First Person being used (only occurs in 2 other places in all of documentation)  (PG Doc comments form <noreply@postgresql.org>)
Responses Re: First Person being used (only occurs in 2 other places in all of documentation)  (Daniel Gustafsson <daniel@yesql.se>)
List pgsql-docs
> On 28 Oct 2022, at 04:44, 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/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.

I agree with this (and the other two emails about the same), these instances
would be better reworded to match the rest of the documentation.

--
Daniel Gustafsson        https://vmware.com/




pgsql-docs by date:

Previous
From: PG Doc comments form
Date:
Subject: First Person (I) Should be avoided
Next
From: PG Doc comments form
Date:
Subject: SET feature