Процедура заведения новых учетных записей

Если Вы собираетесь рекомендовать кого-либо в команду коммиттеров FreeBSD, необходимо послать ответственному лицу письмо со следующей информацией:

Запрос на коммиттерский бит, не оформленный по указанным правилам, будет в лучшем случае отложен в долгий ящик, а то и вызовет раздражение в ваш адрес со стороны ответственной персоны. Для получения некоторых рекомендаций о том, как должно быть написано само предложение, пожалуйста, обратитесь к краткому обзору.

Адреса ответственных лиц по различным частям репозитория:

Вы получите подтверждение после того, как сообщение будет просмотрено, а srcmgr@, doceng@ и portmgr@ ответят вам после завершения голосования или по истечении таймаута. Таймаут для srcmgr@ и portmgr@ установлен в 7 дней, тогда как для doceng@ — 14 дней, однако, как указано, это лишь наихудший случай, и члены команд могут завершить голосование раньше.

Кто-либо из перечисленного ниже списка отправляет по электронной почте на адрес accounts@ письмо, подписанное PGP, копируя наставника, назначенного новому коммиттеру, и с копией core@FreeBSD.org, подтверждающее утверждение новой учётной записи. Это письмо должно содержать ссылку на данный документ, чтобы наставник и подопечный знали, что от них ожидается.

Утверждения новых учётных записей действительны только от следующих PGP-сущностей:

ПРИМЕЧАНИЕ: Запросы на создание новых учётных записей от кого-либо, кроме этих сущностей, или запросы, подписанные PGP-ключами, отличными от ключей этих сущностей, не будут обрабатываться. Исключений нет.

Лицо, назначенное наставником нового коммиттера, должно собрать и отправить следующую информацию на адрес accounts@:

Наставник обязан получить эту информацию от нового коммиттера надёжным способом и передать её в accounts@ также надёжным способом. Предпочтительным методом для отправки информации в accounts@ является письмо, подписанное PGP, при условии, что открытый ключ наставника уже добавлен в Справочник. Если по какой-либо причине это невозможно, допустимой заменой является размещение наставником информации об учётной записи в своём домашнем каталоге на freefall с последующим уведомлением accounts@ о месте размещения. Мы должны быть уверены, что информация об учётной записи действительно исходит от наставника, и неподписанное письмо для этого недостаточно. Поскольку у accounts@ нет способа проверить что-либо от нового коммиттера, эта информация должна быть отправлена в accounts@ наставником, а не новым коммиттером.

accounts@ создаёт новую учётную запись с указанной выше информацией в кластере FreeBSD.org и уведомляет наставника и нового коммиттера.

После того как новый коммиттер подтвердит, что учётная запись работает, наставник добавляет нового коммиттера в соответствующий файл access, используя соответствующее сообщение коммита. Сообщение коммита должно содержать как минимум полное имя и имя пользователя коммиттера, имя наставника и область, в которой новый коммиттер начнёт работать. Также должна быть добавлена запись в файл mentors в соответствующем репозитории Git для указания отношений наставничества. После выполнения всех этих действий новый коммиттер и наставник совместно выполняют первые операции коммита.

Наставник должен добавить нового коммиттера в группу Developers на вики-сайте и в проект committer на Phabricator.

Чтение Руководства коммиттера считается хорошим первым шагом для новых коммиттеров, особенно раздела «Соглашения и традиции».

Период работы с ментором не фиксируется жестко. Когда наставник посчитает, что подопечный готов к самостоятельной работе, наставник уведомляет сообщество разработчиков, удаляя запись из файла mentors ветки internal/admin в репозитории Git.

При необходимости передать опекаемого вами коммиттера другому ментору напишите письмо ответственным, как при создании новой учетной записи. Как правило, подобные запросы утверждаются без лишней волокиты. Сообщество уведомляется о передаче коммиттера путем форсированного коммита в файл mentors в Git.