Team/Join/Candidate: различия между версиями

Материал из ALT Linux Wiki
< Team‎ | Join
(→‎Создание заявки: Разъяснение как прикладывать два файла)
(Запрет на комментарии в gpg-ключе)
 
(не показаны 34 промежуточные версии 17 участников)
Строка 1: Строка 1:
Если вы считаете, что какого-то пакета в Сизифе не хватает, или что какой-то пакет заслуживает большего внимания и готовы заняться им — значит, настало время присоединиться к команде ALT Linux Team.
Если вы считаете, что какого-то пакета в Сизифе не хватает, или что какой-то пакет заслуживает большего внимания и готовы заняться им — значит, настало время [[Team/Join|присоединиться]] к команде [[ALT Linux Team]].


== Сбор информации ==
== Сбор информации ==
Строка 5: Строка 5:
Для принятия в Team необходима следующая информация:
Для принятия в Team необходима следующая информация:


* имя ментора — участника команды, имеющего желание помогать в процессе приёма в Team. Менторов можно искать в [[Списки рассылки|списках рассылки]] или на [[IRC]]-канале.
* имя ментора — участника команды, имеющего желание помогать в процессе приёма в Team. Менторов можно искать в [[Списки рассылки|списках рассылки]], канале [http://telegram.me/alt_linux Telegram] или на [[IRC]]-канале;
* псевдоним (имя пользователя) участника, выбирается им самим. Имя должно начинаться с буквы, содержать только буквы и цифры и быть не короче трёх символов.
* псевдоним (имя пользователя) участника. Выбирается им самим. Имя должно начинаться с буквы, содержать только строчные латинские буквы и цифры, быть не короче трёх символов;
* адрес почты, на который будет производиться пересылка с адреса <tt>псевдоним@altlinux.org</tt>.
** Псевдоним — это фактичеcки ваше второе имя в команде. Так вас будут называть в глаза и за глаза, по нему на вас будут ссылаться. Поэтому псевдоним лучше выбирать короткий, запоминающийся и не отягощённый мусором. Например, ''yoda'' — удобный псевдоним, а ''travellingwilburys1998'' — неудобный. Список уже занятых имён можно посмотреть в пакете [http://git.altlinux.org/gears/a/alt-gpgkeys.git?p=alt-gpgkeys.git;a=tree;f=keys alt-gpgkeys]
* SSH-ключ (RSA 2048bit или DSA 1024bit). Принимающему нужна публичная часть ключа. Этот ключ будет использоваться для SSH-доступа на ресурсы Sisyphus ([[git.alt]] и другие).
* адрес почты, на который будет производиться пересылка с адреса <tt>псевдоним@altlinux.org</tt>;
* GPG-ключ (DSA и ElGamal 1024bit). В ключе должен быть uid вида <tt>псевдоним@altlinux.org</tt>. Принимающему нужна публичная часть ключа. Этот ключ будет использоваться для подписи пакетов и для удостоверения личности в почте.
* SSH-ключ (ED25519 или RSA >= 4096bit). Принимающему нужна публичная часть ключа. Этот ключ будет использоваться для SSH-доступа на ресурсы Sisyphus ([[git.alt]] и другие);
* GPG-ключ (RSA >= 4096bit). В ключе должны быть имя в формате "<First name> <Last name>" и uid вида <tt>псевдоним@altlinux.org</tt>, комментарий следует оставить пустым. Принимающему нужна публичная часть ключа. Этот ключ будет использоваться для подписи пакетов и для удостоверения личности в почте.


Если у вас нет ssh- или GPG-ключа, прочтите статью «[[Работа с ключами разработчика]]».
Если у вас ещё нет SSH- или GPG-ключа, прочтите статью «[[Работа с ключами разработчика]]».


== Создание заявки ==
== Создание заявки ==


Заявка создаётся добавлением «бага» в [[BugTracking/BugzillaMiniHowto|Bugzilla]]. Такие «баги» читает специальный член команды — секретарь.
Заявка создаётся кандидатом в [[BugTracking/BugzillaMiniHowto|Bugzilla]]. Такие баги читает специальный член команды — секретарь.


Баг должен быть оформлен следующим образом:
Баг должен быть оформлен следующим образом:


* Баг должен быть заведён в разделе «Development», продукте «Team accounts», на компонент «join»,
* [http://bugzilla.altlinux.org/enter_bug.cgi?product=Team%20Accounts&component=join заведён] на компонент «join» в разделе «Development», где продуктом должен быть указан «Team Accounts»,
* в теле бага нужно указать псевдоним (имя пользователя) участника, адрес пересылки почты, а также несколько слов о том, чем вы намерены заняться в ALT Linux Team («собрать для начала такой-то пакет, а потом, если получится, ещё пакеты из такой-то области», «просто помочь со сборкой чего-нибудь», «научиться собирать пакеты» и т. п.),
* в теле бага нужно указать псевдоним (имя пользователя) нового участника, адрес пересылки почты, имя ментора, а также несколько слов о том, чем кандидат намерен заняться в ALT Linux Team на момент подачи заявки на вступление («собрать для начала такой-то пакет, а потом, если получится, ещё пакеты из такой-то области», «просто помочь со сборкой чего-нибудь», «научиться собирать пакеты», «у вас тут [http://bugzilla.altlinux.org/buglist.cgi?bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&product=New%2Fproposed%20packages&query_format=advanced хотелка] висит» и т. п.),
* E-mail ментора следует добавить в поле CC к создаваемому багу (Поле "Подписка:"),
** '''NB''': от заявленной кандидатом цели могут зависеть, в частности, требования [[Team/Join/Mentor|ментора]] и [[Team/Join/Reviewer|рецензента]] к обретаемым кандидатом навыкам и их пристрастие.
* Публичный SSH-ключ и GPG-ключ нужно приложить к «багу» в виде отдельных приложений (attachments), в виде обычных файлов. GPG-ключ необходимо приложить в экспортированном виде (<tt>gpg --export --armor <id ключа></tt>). Файлы можно прикладывать уже после создания баги.
* e-mail ментора следует добавить в поле CC («Подписка»), чтобы он мог должным образом подтвердить своё менторство,
* публичный SSH-ключ и публичный GPG-ключ нужно приложить к багу в виде отдельных приложений (attachments) обычными файлами. GPG-ключ необходимо приложить в экспортированном виде (<tt>gpg --export --armor <id ключа></tt>). Файлы можно прикладывать уже после создания бага. Проверьте, что экспортировали единственный ключ, а не более (<tt>gpg %путь-до-файла%</tt>)


== Обработка заявки ==
== Обработка заявки ==
Строка 28: Строка 30:
После получения необходимой информации секретарь проверяет приложенные ключи, создаёт e-mail адрес и выдаёт ограниченный доступ в git.alt (без возможности сборки пакетов).
После получения необходимой информации секретарь проверяет приложенные ключи, создаёт e-mail адрес и выдаёт ограниченный доступ в git.alt (без возможности сборки пакетов).


Помните, что и секретарь, и менторы являются добровольцами, и поэтому не всегда имеют время сразу ответить на ваши сообщения/письма/заявки, поэтому, пожалуйства, проявите терпение в случае задержки.
Помните, что и секретарь, и менторы являются добровольцами, и поэтому не всегда имеют время сразу ответить на ваши сообщения/письма/заявки поэтому, пожалуйста, проявите терпение в случае задержки (но если не отвечают уже месяц, имеет смысл напомнить о себе).
 
Секретарь ведёт процесс обработки заявки по [[Team/Join/Secretary|регламенту]]. При переходе на новый этап секретарь обычно указывает номер этапа в открытом кандидатом баге.


== Работа с ментором ==
== Работа с ментором ==


* Ментор помогает новому участнику собирать пакеты, проверяя корректность пакетирования.
* Ментор помогает новому участнику собирать пакеты, проверяя корректность пакетирования.
* Ментор определяет момент, когда новый участник освоился с инструментарием, а также освоил основные правила пакетирования, и уведомляет об этом секретаря.
* Ментор определяет момент, когда кандидат освоился с инструментарием и освоил основные правила пакетирования, после чего уведомляет об этом секретаря.
* Секретарь добавляет GPG-ключ принимаемого в связку alt-gpgkeys и подписывает нового участника на {{lists|devel}}.
* Секретарь добавляет GPG-ключ принимаемого в связку {{pkg|alt-gpgkeys}}.
* С этого момента ментор может отправлять в репозиторий пакеты, подготовленные и подписанные новым участником.
* С этого момента кандидат может отправлять в сборочницу тестовые задания, которые смогут попасть в репозиторий только после утверждения (approve) ментором (или любым другим членом Team).
* Ментор определяет момент, когда новый участник научился совместно работать над пакетами (в частности, с ментором), и уведомляет об этом секретаря.
* Ментор определяет момент, когда кандидат научился совместно работать над пакетами (в частности, с ментором) и пользоваться сборочницей, и уведомляет об этом секретаря.


Так как у ментора не всегда будет достаточно времени, чтобы оперативно отвечать на все вопросы, настоятельно рекомендуется подписаться на рассылку [https://lists.altlinux.org/mailman/listinfo/devel-newbies devel-newbies@] и/или находиться на irc-канале #altlinux-devel (см. статью [[IRC |irc-каналы ALT Linux]]) и задавать какие-то вопросы там. Также будьте готовы к тому, что собеседник может покритиковать ваши коммиты в git, указать на ошибки.
Так как у ментора не всегда будет достаточно времени, чтобы оперативно отвечать на все вопросы, настоятельно рекомендуется подписаться на рассылку {{lists|devel-newbies}} и задавать возникающие вопросы там. Также будьте готовы к тому, что собеседник может покритиковать ваши коммиты в git, указать на ошибки; при сомнениях можно спросить, это техническая претензия или вопрос личных предпочтений (бывает и то, и другое).


== Завершение процедуры ==
== Завершение процедуры ==


После получения «отмашки» от ментора секретарь выдаёт полный доступ в [[git.alt]]. Начиная с этого момента новый участник становится полноправным членом команды.
После получения «отмашки» от ментора секретарь выдаёт полный доступ в [[git.alt]] и подписывает нового участника на {{lists|devel}}. Начиная с этого момента кандидат становится полноправным членом команды.


[[Категория:Sisyphus]]
[[Категория:Sisyphus]]
[[Категория:Руководства]]
[[Категория:Руководства]]
[[Категория:Team]]
{{Category navigation|title=Team|category=Team|sortkey=*}}

Текущая версия от 16:46, 7 октября 2024

Если вы считаете, что какого-то пакета в Сизифе не хватает, или что какой-то пакет заслуживает большего внимания и готовы заняться им — значит, настало время присоединиться к команде ALT Linux Team.

Сбор информации

Для принятия в Team необходима следующая информация:

  • имя ментора — участника команды, имеющего желание помогать в процессе приёма в Team. Менторов можно искать в списках рассылки, канале Telegram или на IRC-канале;
  • псевдоним (имя пользователя) участника. Выбирается им самим. Имя должно начинаться с буквы, содержать только строчные латинские буквы и цифры, быть не короче трёх символов;
    • Псевдоним — это фактичеcки ваше второе имя в команде. Так вас будут называть в глаза и за глаза, по нему на вас будут ссылаться. Поэтому псевдоним лучше выбирать короткий, запоминающийся и не отягощённый мусором. Например, yoda — удобный псевдоним, а travellingwilburys1998 — неудобный. Список уже занятых имён можно посмотреть в пакете alt-gpgkeys
  • адрес почты, на который будет производиться пересылка с адреса псевдоним@altlinux.org;
  • SSH-ключ (ED25519 или RSA >= 4096bit). Принимающему нужна публичная часть ключа. Этот ключ будет использоваться для SSH-доступа на ресурсы Sisyphus (git.alt и другие);
  • GPG-ключ (RSA >= 4096bit). В ключе должны быть имя в формате "<First name> <Last name>" и uid вида псевдоним@altlinux.org, комментарий следует оставить пустым. Принимающему нужна публичная часть ключа. Этот ключ будет использоваться для подписи пакетов и для удостоверения личности в почте.

Если у вас ещё нет SSH- или GPG-ключа, прочтите статью «Работа с ключами разработчика».

Создание заявки

Заявка создаётся кандидатом в Bugzilla. Такие баги читает специальный член команды — секретарь.

Баг должен быть оформлен следующим образом:

  • заведён на компонент «join» в разделе «Development», где продуктом должен быть указан «Team Accounts»,
  • в теле бага нужно указать псевдоним (имя пользователя) нового участника, адрес пересылки почты, имя ментора, а также несколько слов о том, чем кандидат намерен заняться в ALT Linux Team на момент подачи заявки на вступление («собрать для начала такой-то пакет, а потом, если получится, ещё пакеты из такой-то области», «просто помочь со сборкой чего-нибудь», «научиться собирать пакеты», «у вас тут хотелка висит» и т. п.),
    • NB: от заявленной кандидатом цели могут зависеть, в частности, требования ментора и рецензента к обретаемым кандидатом навыкам и их пристрастие.
  • e-mail ментора следует добавить в поле CC («Подписка»), чтобы он мог должным образом подтвердить своё менторство,
  • публичный SSH-ключ и публичный GPG-ключ нужно приложить к багу в виде отдельных приложений (attachments) обычными файлами. GPG-ключ необходимо приложить в экспортированном виде (gpg --export --armor <id ключа>). Файлы можно прикладывать уже после создания бага. Проверьте, что экспортировали единственный ключ, а не более (gpg %путь-до-файла%)

Обработка заявки

После получения необходимой информации секретарь проверяет приложенные ключи, создаёт e-mail адрес и выдаёт ограниченный доступ в git.alt (без возможности сборки пакетов).

Помните, что и секретарь, и менторы являются добровольцами, и поэтому не всегда имеют время сразу ответить на ваши сообщения/письма/заявки — поэтому, пожалуйста, проявите терпение в случае задержки (но если не отвечают уже месяц, имеет смысл напомнить о себе).

Секретарь ведёт процесс обработки заявки по регламенту. При переходе на новый этап секретарь обычно указывает номер этапа в открытом кандидатом баге.

Работа с ментором

  • Ментор помогает новому участнику собирать пакеты, проверяя корректность пакетирования.
  • Ментор определяет момент, когда кандидат освоился с инструментарием и освоил основные правила пакетирования, после чего уведомляет об этом секретаря.
  • Секретарь добавляет GPG-ключ принимаемого в связку alt-gpgkeys.
  • С этого момента кандидат может отправлять в сборочницу тестовые задания, которые смогут попасть в репозиторий только после утверждения (approve) ментором (или любым другим членом Team).
  • Ментор определяет момент, когда кандидат научился совместно работать над пакетами (в частности, с ментором) и пользоваться сборочницей, и уведомляет об этом секретаря.

Так как у ментора не всегда будет достаточно времени, чтобы оперативно отвечать на все вопросы, настоятельно рекомендуется подписаться на рассылку devel-newbies@ и задавать возникающие вопросы там. Также будьте готовы к тому, что собеседник может покритиковать ваши коммиты в git, указать на ошибки; при сомнениях можно спросить, это техническая претензия или вопрос личных предпочтений (бывает и то, и другое).

Завершение процедуры

После получения «отмашки» от ментора секретарь выдаёт полный доступ в git.alt и подписывает нового участника на devel@. Начиная с этого момента кандидат становится полноправным членом команды.