Differences

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

--- взаимодействие_в_сообществе_postgresql [2024/11/09 20:44] – 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 22: / Line 25: @@
 Если не требуется отправлять другие письма, можно отписаться от рассылки. Для отслеживания ответов можно просматривать соответствующую ветку в архиве рассылок.
-Если отправляется патч.
+=== Если требуется отправить ответ ===
+Важно писать свои сообщения после цитируемого текста предыдущих писем. Так принято в сообществе. Цитировать можно не полностью.
+=== Если отправляется патч ===
+Все изменения кода требуется объединить в один коммит поверх последнего коммита ветки master, загруженной из https://git.postgresql.org/git/postgresql.git.
-Все изменения кода требуется объединить в один коммит поверх последнего коммита ветки master, загруженной из [https://git.postgresql.org/git/postgresql.git]https://git.postgresql.org/git/postgresql.git.
+Изменения принимаются в виде файлов патчей, которые должны быть приложены к письму. Сделать этот файл из последнего коммита можно командой
+  git format-patch -1 HEAD
-Изменения принимаются в виде файлов патчей, которые должны быть приложены к письму. Сделать этот файл из последнего коммита можно командой git format-patch -1 HEAD. Убедиться, что патч корректно применяется к коду ветки master можно с помощью git apply patchname.patch. Кроме файла патча, можно отправить ссылку на репозиторий на github.
+Убедиться, что патч корректно применяется к коду ветки master можно с помощью
+  git apply patchname.patch
-Программный код должен соответствовать требованиям сообщества (https://www.postgresql.org/docs/current/source.html). Описание коммита должно быть на на английском языке и выровнено по границе 80 символов. Также требуется проверить коммит на соответствие требованиям форматирования с помощью команды git show --check.
+Кроме файла патча, можно отправить ссылку на репозиторий на github.
+Программный код должен соответствовать требованиям сообщества (https://www.postgresql.org/docs/current/source.html). Описание коммита должно быть на английском языке и выровнено по границе 80 символов. Также требуется проверить коммит на соответствие требованиям форматирования с помощью команды
+  git show --check
-Тема письма должна ёмко описывать предлагаемые изменения, так как она будет использоваться для именования ветки в архиве рассылок. Текст тела письмо можно взять из коммита, а также можно дополнить его своими комментариями и вопросами.
+Тема письма должна ёмко описывать предлагаемые изменения, так как она будет использоваться для именования ветки в архиве рассылок. Текст тела письма можно взять из описания коммита (не забыв убрать разбивку по 80 символов), а также можно дополнить его своими комментариями и вопросами.
 Подробнее процедура подготовки и принятия патчей описана на https://wiki.postgresql.org/wiki/Submitting_a_Patch.