Differences

This shows you the differences between two versions of the page.

--- взаимодействие_в_сообществе_postgresql [2024/11/09 20:49] – keremet
+++ взаимодействие_в_сообществе_postgresql [2024/11/10 14:35] (current) – keremet
@@ Line 11: / Line 11: @@
 Для проверки работоспособности подписки можно отправить себе тестовое письмо (кнопка "Send test mail").
-После этого на указанную почту будут приходить все письма из рассылки. Рекомендуется настроить фильтр почты. Например, на веб-интерфейсе на Яндекса он будет выглядеть так:
+После этого на указанную почту будут приходить все письма из рассылки. Рекомендуется настроить фильтр почты. Например, на веб-интерфейсе Яндекса он будет выглядеть так:
 {{::pasted-image-20241107114351.png|}}
-Как только подписка выполнена, можно отправлять письмо со своим вопросом на адрес рассылки (например, pgsql-hackers@lists.postgresql.org). Отправлять письмо лучше из программы почтового клиента, например, Thunderbird (инструкция по интеграции с яндекс почтой https://yandex.ru/support/yandex-360/customers/mail/ru/mail-clients/mozilla-thunderbird.html). При отправке через веб интерфейс Яндекса портится форматирование при просмотре письма в списке рассылок (можно решить отключением форматирования в веб-интерфейсе), а также в поле Message-ID добавляется приставка @mail.yandex.ru.
+Как только подписка выполнена, можно отправлять письмо со своим вопросом на адрес рассылки (например, pgsql-hackers@lists.postgresql.org). Отправлять письмо лучше из программы почтового клиента, например, Thunderbird (инструкция по интеграции с почтой Яндекса https://yandex.ru/support/yandex-360/customers/mail/ru/mail-clients/mozilla-thunderbird.html). При отправке через веб интерфейс Яндекса портится форматирование при просмотре письма в списке рассылок (можно решить отключением форматирования в веб-интерфейсе), а также в поле Message-ID добавляется приставка @mail.yandex.ru.
 {{::20241109_3.png|}}
+При написании письма надо учитывать, что на сайте архива рассылки текст отображается с выравниванием на границу 70 символов.
 После отправки требуется убедиться что в архиве рассылок появилась новая ветка с названием "Re: тема письма". Может появиться не сразу, требуется некоторое время на синхронизацию. Ответы от сообщества будут приходить с темой "Re: тема письма" и попадать в эту же ветку.
@@ Line 23: / Line 25: @@
 Если не требуется отправлять другие письма, можно отписаться от рассылки. Для отслеживания ответов можно просматривать соответствующую ветку в архиве рассылок.
-Если отправляется патч.
+=== Если требуется отправить ответ ===
-Все изменения кода требуется объединить в один коммит поверх последнего коммита ветки master, загруженной из [https://git.postgresql.org/git/postgresql.git]https://git.postgresql.org/git/postgresql.git.
+Важно писать свои сообщения после цитируемого текста предыдущих писем. Так принято в сообществе. Цитировать можно не полностью.
+=== Если отправляется патч ===
+Все изменения кода требуется объединить в один коммит поверх последнего коммита ветки master, загруженной из https://git.postgresql.org/git/postgresql.git.
 Изменения принимаются в виде файлов патчей, которые должны быть приложены к письму. Сделать этот файл из последнего коммита можно командой
@@ Line 35: / Line 41: @@
 Кроме файла патча, можно отправить ссылку на репозиторий на github.
-Программный код должен соответствовать требованиям сообщества (https://www.postgresql.org/docs/current/source.html). Описание коммита должно быть на на английском языке и выровнено по границе 80 символов. Также требуется проверить коммит на соответствие требованиям форматирования с помощью команды
+Программный код должен соответствовать требованиям сообщества (https://www.postgresql.org/docs/current/source.html). Описание коммита должно быть на английском языке и выровнено по границе 80 символов. Также требуется проверить коммит на соответствие требованиям форматирования с помощью команды
   git show --check
-Тема письма должна ёмко описывать предлагаемые изменения, так как она будет использоваться для именования ветки в архиве рассылок. Текст тела письмо можно взять из коммита, а также можно дополнить его своими комментариями и вопросами.
+Тема письма должна ёмко описывать предлагаемые изменения, так как она будет использоваться для именования ветки в архиве рассылок. Текст тела письма можно взять из описания коммита (не забыв убрать разбивку по 80 символов), а также можно дополнить его своими комментариями и вопросами.
 Подробнее процедура подготовки и принятия патчей описана на https://wiki.postgresql.org/wiki/Submitting_a_Patch.