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

Поиск
Список
Период
Сортировка
От Daniel Gustafsson
Тема Re: First Person being used (only occurs in 2 other places in all of documentation)
Дата
Msg-id A324F1A0-5E09-47F0-A83E-F9AB0D35853D@yesql.se
обсуждение исходный текст
Ответ на Re: First Person being used (only occurs in 2 other places in all of documentation)  (Daniel Gustafsson <daniel@yesql.se>)
Ответы Re: First Person being used (only occurs in 2 other places in all of documentation)  (Daniel Gustafsson <daniel@yesql.se>)
Список 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/


Вложения

В списке pgsql-docs по дате отправления:

Предыдущее
От: PG Doc comments form
Дата:
Сообщение: SET feature
Следующее
От: Laurenz Albe
Дата:
Сообщение: Re: SET feature