Политика взносов

На этой странице рассказывается о модели управления Bazel и политике взносов.

Модель управления

Проект Bazel возглавляется и управляется Google и имеет большое сообщество участников за пределами Google. Некоторые компоненты Bazel (например, определенные репозитории правил в рамках организации bazelbuild ) возглавляются, обслуживаются и управляются членами сообщества. Команда Google Bazel рассматривает предложения по добавлению принадлежащих сообществу репозиториев (например, правил) в организацию bazelbuild GitHub.

Роли участников

Вот краткое описание ролей в проекте Bazel, включая их обязанности:

  • Владельцы : команда Google Bazel. Владельцы несут ответственность за:
    • Стратегия, сопровождение и руководство проектом Базель.
    • Создание и поддержка основных функций Bazel.
    • Назначение сопровождающих и утверждение новых репозиториев.
  • Сопровождающие : команда Google Bazel и назначенные пользователи GitHub. Сопровождающие несут ответственность за:
    • Создание и поддержка основной функциональности своего репозитория.
    • Проверка и утверждение вкладов в области кодовой базы Bazel.
    • Поддержка пользователей и участников за счет своевременного и прозрачного управления проблемами, проверки связей с общественностью и документации.
    • Выпуск, тестирование и сотрудничество с владельцами Bazel.
  • Участники : все пользователи, которые вносят код или документацию в проект Bazel.
    • Создание хорошо написанных PR для внесения вклада в кодовую базу и документацию Bazel.
    • Использование стандартных каналов, таких как GitHub Issues, чтобы предлагать изменения и сообщать о проблемах.

Стать сопровождающим

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

Политика взносов

Проект Bazel принимает вклады от внешних участников. Ниже приведены правила публикации для областей кода, управляемых Google и Сообществом.

  • Лицензирование . Все специалисты по сопровождению и участники должны подписать Лицензионное соглашение Google для участников .
  • Взносы . Владельцы и сопровождающие должны приложить все усилия, чтобы принять достойный вклад. Все взносы должны быть:
    • Хорошо написано и проверено
    • Обсуждается и утверждается сопровождающими соответствующей области кода. Обсуждения и утверждения происходят на GitHub Issues и в GitHub PR. Более крупные взносы требуют пересмотра дизайна .
    • Добавляется в систему непрерывной интеграции Bazel, если еще не присутствует.
    • Поддерживается и согласуется с направлением продукта Bazel
  • Обзор кода . Все изменения во всех репозиториях bazelbuild требуют проверки:
    • Все PR должны быть одобрены владельцем или сопровождающим.
    • Только владельцы и сопровождающие могут объединять PR.
  • Совместимость . Владельцам может потребоваться отклонить или запросить изменение PR в том маловероятном случае, если изменение потребует существенных изменений во внутренних системах Google.
  • Документация . Там, где это уместно, вклады в функции должны включать обновления документации.

Для получения более подробной информации о вкладе в Bazel ознакомьтесь с нашими рекомендациями по вкладу .