Взаимодействие в сообществе 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.

Чтобы отправить письмо в рассылку, на нее требуется подписаться. Форма должна выглядеть примерно следующим образом:

Для проверки работоспособности подписки можно отправить себе тестовое письмо (кнопка “Send test mail”).

После этого на указанную почту будут приходить все письма из рассылки. Рекомендуется настроить фильтр почты. Например, на веб-интерфейсе Яндекса он будет выглядеть так:

Как только подписка выполнена, можно отправлять письмо со своим вопросом на адрес рассылки (например, 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.

При написании письма надо учитывать, что на сайте архива рассылки текст отображается с выравниванием на границу 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.