BazelCon 2022 пройдет 16-17 ноября в Нью-Йорке и онлайн.
Зарегистрируйтесь сегодня!

Базельские группы по интересам

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

Bazel поддерживает специальные группы по интересам (SIG), чтобы сосредоточить сотрудничество в определенных областях и поддерживать общение и координацию между владельцами Bazel, сопровождающими и участниками . Эта политика применяется к bazelbuild .

SIG делают свою работу публично. Идеальная сфера деятельности SIG охватывает четко определенную область, в которой большую часть участия представляет сообщество. SIG могут сосредоточиться на поддерживаемых сообществом репозиториях в bazelbuild (например, языковых правилах) или сосредоточиться на областях кода в репозитории Bazel (например, на удаленном выполнении).

Хотя не все SIG будут иметь одинаковый уровень энергии, широту охвата или модели управления, должно быть достаточно доказательств того, что есть члены сообщества, желающие участвовать и вносить свой вклад в случае создания группы по интересам. Прежде чем присоединиться, ознакомьтесь с работой группы, а затем свяжитесь с руководителем SIG. Политика членства варьируется в зависимости от SIG.

См. полный список SIG Bazel .

Нецели: чем SIG не является

SIG предназначены для облегчения совместной работы. Таким образом, SIG:

  • Не форум поддержки: список рассылки и SIG — не одно и то же
  • Не требуется немедленно: в начале жизни проекта вы можете не знать, есть ли у вас совместная работа или соавторы.
  • Небесплатный труд: требуется энергия для роста и координации совместной работы.

Владельцы Bazel придерживаются консервативного подхода к созданию SIG — благодаря простоте запуска проектов на GitHub существует множество возможностей для совместной работы без необходимости в SIG.

Жизненный цикл SIG

В этом разделе рассказывается, как создать SIG.

Исследования и консультации

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

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

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

Создать новую группу

Новая группа должна следовать приведенному ниже процессу для фрахтования. В частности, он должен демонстрировать:

  • Четкая цель и выгода для Bazel (либо в рамках подпроекта, либо в области применения)
  • Два или более участника, желающие действовать в качестве руководителей группы, наличие других участников и свидетельство спроса на группу
  • Каждая группа должна использовать как минимум один общедоступный список рассылки. SIG может повторно использовать один из общедоступных списков, например bazel-discuss , запросить список для @bazel.build или создать свой собственный список.
  • Ресурсы, которые изначально требуются SIG (обычно это список рассылки и обычный видеозвонок).
  • SIG могут обслуживать документы и файлы из своего каталога в bazelbuild/community или из собственного репозитория в организации bazelbuild GitHub. SIG могут ссылаться на внешние ресурсы, если они решат организовать свою работу за пределами организации bazelbuild GitHub.
  • Владельцы Bazel одобряют или отклоняют заявки SIG и при необходимости консультируются с другими заинтересованными сторонами.

Прежде чем приступить к формальным частям процесса, вам следует проконсультироваться с командой разработчиков Bazel по адресу product@bazel.build. Большинство SIG требуют обсуждения и итерации перед утверждением.

Официальный запрос на новую группу делается путем подачи устава в качестве PR на bazelbuild/community и включения запроса в комментарии к PR в соответствии с приведенным ниже шаблоном. После утверждения PR для группы объединяется и создаются необходимые ресурсы.

Запрос шаблона для нового SIG

Чтобы запросить новый SIG, используйте шаблон в репозитории сообщества: SIG-request-template.md .

Фрахтование

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

В уставе должен быть назначен администратор. Помимо администратора, в группу должен входить как минимум один человек в качестве руководителя (это может быть один и тот же человек), который служит контактным лицом для координации, как это требуется, с командой продукта Bazel.

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

Сотрудничество и включение

Хотя это и не обязательно, группа должна решить использовать совместную работу посредством запланированных телефонных конференций или каналов чата для проведения собраний. Объявления о любых таких встречах следует размещать в списке рассылки, а заметки размещать в списке рассылки впоследствии. Регулярные встречи помогают повысить ответственность и прогресс в SIG.

Члены команды разработчиков Bazel могут активно отслеживать и поощрять группу к обсуждению и действиям по мере необходимости.

Запустить SIG

Необходимые действия:

  • Уведомить общие группы обсуждения Bazel ( bazel- discuss , bazel-dev ).

Дополнительные мероприятия:

  • Создайте сообщение в блоге для блога Bazel

Состояние и прекращение SIG

Владельцы Bazel делают все возможное, чтобы обеспечить здоровье SIG. Владельцы Bazel время от времени запрашивают у руководства SIG отчет о работе SIG, чтобы информировать более широкое сообщество Bazel о деятельности группы.

Если у SIG больше нет полезной цели или заинтересованного сообщества, его можно заархивировать и прекратить работу. Команда разработчиков Bazel оставляет за собой право архивировать такие неактивные SIG для поддержания общего состояния проекта, хотя это менее предпочтительный результат. SIG также может принять решение о роспуске, если признает, что срок его полезного использования истек.

Примечание

Этот контент был взят из сборника игр Tensorflow SIG с изменениями.