Re: First Person being used (only occurs in 2 other places in all of documentation)

From: Daniel Gustafsson <daniel(at)yesql(dot)se>
To: wolakk(at)gmail(dot)com, pgsql-docs(at)lists(dot)postgresql(dot)org
Subject: Re: First Person being used (only occurs in 2 other places in all of documentation)
Date: 2022-10-28 10:50:47
Message-ID: A324F1A0-5E09-47F0-A83E-F9AB0D35853D@yesql.se
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

> On 28 Oct 2022, at 11:30, Daniel Gustafsson <daniel(at)yesql(dot)se> wrote:
>
>> On 28 Oct 2022, at 04:44, 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/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 Content-Type Size
first_person.diff application/octet-stream 2.9 KB

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Laurenz Albe 2022-10-28 11:59:08 Re: SET feature
Previous Message PG Doc comments form 2022-10-28 10:14:06 SET feature