Differences

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

--- взаимодействие_в_сообществе_postgresql [2024/11/09 19:56] – created keremet
+++ взаимодействие_в_сообществе_postgresql [2024/11/10 14:35] (current) – keremet
@@ Line 1: / Line 1: @@
+====== Взаимодействие в сообществе PostgreSQL ======
 Общение в сообществе PostgreSQL осуществляется через рассылки, а чтобы подписаться на них, требуется учетка на www.postgresql.org. Для ее создания надо перейти по ссылке https://www.postgresql.org/account/signup. К учетке можно привязать несколько почтовых ящиков (https://www.postgresql.org/account/profile/) и на странице управления подписками (https://lists.postgresql.org/manage/) выбирать, из какой рассылки на какие адреса пойдут письма.
+Перед тем как отправлять изменения или задавать вопросы, требуется убедиться, что данная тема не поднималась ранее. Для этого надо выбрать соответствующую вопросу рассылку и воспользоваться поиском по архиву сообщений (https://www.postgresql.org/list/). Для обсуждения идей доработок и конкретных предложений по изменению кода есть рассылка pgsql-hackers@lists.postgresql.org.
+Чтобы отправить письмо в рассылку, на нее требуется подписаться. Форма должна выглядеть примерно следующим образом:
+{{::20241109_1.png|}}
+Для проверки работоспособности подписки можно отправить себе тестовое письмо (кнопка "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.
+{{::20241109_3.png|}}
+При написании письма надо учитывать, что на сайте архива рассылки текст отображается с выравниванием на границу 70 символов.
+После отправки требуется убедиться что в архиве рассылок появилась новая ветка с названием "Re: тема письма". Может появиться не сразу, требуется некоторое время на синхронизацию. Ответы от сообщества будут приходить с темой "Re: тема письма" и попадать в эту же ветку.
+Если не требуется отправлять другие письма, можно отписаться от рассылки. Для отслеживания ответов можно просматривать соответствующую ветку в архиве рассылок.
+=== Если требуется отправить ответ ===
+Важно писать свои сообщения после цитируемого текста предыдущих писем. Так принято в сообществе. Цитировать можно не полностью.
+=== Если отправляется патч ===
+Все изменения кода требуется объединить в один коммит поверх последнего коммита ветки master, загруженной из https://git.postgresql.org/git/postgresql.git.
+Изменения принимаются в виде файлов патчей, которые должны быть приложены к письму. Сделать этот файл из последнего коммита можно командой
+  git format-patch -1 HEAD
+Убедиться, что патч корректно применяется к коду ветки master можно с помощью
+  git apply patchname.patch
+Кроме файла патча, можно отправить ссылку на репозиторий на github.
+Программный код должен соответствовать требованиям сообщества (https://www.postgresql.org/docs/current/source.html). Описание коммита должно быть на английском языке и выровнено по границе 80 символов. Также требуется проверить коммит на соответствие требованиям форматирования с помощью команды
+  git show --check
+Тема письма должна ёмко описывать предлагаемые изменения, так как она будет использоваться для именования ветки в архиве рассылок. Текст тела письма можно взять из описания коммита (не забыв убрать разбивку по 80 символов), а также можно дополнить его своими комментариями и вопросами.
+Подробнее процедура подготовки и принятия патчей описана на https://wiki.postgresql.org/wiki/Submitting_a_Patch.