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 A324F1A0-5E09-47F0-A83E-F9AB0D35853D@yesql.se
Whole thread Raw
In response to Re: First Person being used (only occurs in 2 other places in all of documentation)  (Daniel Gustafsson <daniel@yesql.se>)
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 11:30, Daniel Gustafsson <daniel@yesql.se> wrote:
>
>> 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.

The attached patch rewords the first person form sentences to match the rest of
the documentation.  The "acknowledgment" sections are left as-is as I believe
they are free to have a more personal form.

I also re-arranged the section on PO file editors a bit to keep the PO file
editor paragraph on editors only and not also contain important translation
information.

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


Attachment

pgsql-docs by date:

Previous
From: PG Doc comments form
Date:
Subject: SET feature
Next
From: Laurenz Albe
Date:
Subject: Re: SET feature