Règles pour les contributions

Cette page décrit le modèle de gouvernance et les règles de contribution de Bazel.

Modèle de gouvernance

Le projet Bazel est dirigé et géré par Google, et représente une vaste communauté de contributeurs extérieurs à Google. Certains composants Bazel (tels que des dépôts de règles spécifiques sous l'organisation bazelbuild) sont dirigés, gérés et gérés par les membres de la communauté. L'équipe Google Bazel examine les suggestions d'ajout de dépôts appartenant à la communauté (tels que des règles) à l'organisation GitHub bazelbuild.

Rôles de contributeur

Voici un aperçu des rôles disponibles dans le projet Bazel, y compris leurs responsabilités:

  • Propriétaires: équipe Google Bazel. Les propriétaires sont responsables :
    • Stratégie, maintenance et direction du projet Bazel
    • Créer et gérer les fonctionnalités principales de Bazel
    • Désigner des responsables et approuver les nouveaux dépôts.
  • Responsables: équipe Google Bazel et utilisateurs GitHub désignés. Les responsables de l'association sont responsables :
    • Créer et gérer les principales fonctionnalités de leur dépôt.
    • Examiner et approuver les contributions aux domaines du code base Bazel
    • Aider les utilisateurs et les contributeurs à gérer les problèmes au moment opportun et de façon transparente, et à procéder à l'examen des relations publiques et à la documentation associées.
    • Publier, tester et collaborer avec les propriétaires de Bazel
  • Contributeurs: tous les utilisateurs qui contribuent au code ou à la documentation du projet Bazel.
    • Créer des PR bien écrites pour contribuer au codebase et à la documentation de Bazel
    • Utiliser des canaux standards, tels que les problèmes GitHub, pour proposer des modifications et signaler les problèmes.

Devenir responsable

Les propriétaires Bazel peuvent désigner des responsables pour diriger des zones de code bien définies, telles que des jeux de règles. Les contributeurs qui ont fait preuve d'une contribution régulière et responsable, et qui planifient de grandes contributions à l'avenir, peuvent être considérés comme de bons responsables.

Règles pour les contributions

Le projet Bazel accepte les contributions des contributeurs externes. Voici les règles de contribution pour les zones de code gérées par Google et par la communauté.

  • Licences : Tous les responsables et les contributeurs doivent signer l'accord de licence des contributeurs de Google.
  • Contributions : Les propriétaires et les responsables doivent faire tout leur possible pour accepter ces contributions. Toutes les contributions doivent être :
    • Bien rédigé et bien testé
    • Discussion et approbation par les responsables du domaine de code concerné. Les discussions et les approbations ont lieu sur les problèmes GitHub et dans les PR de GitHub. Les contributions plus importantes nécessitent un examen de la conception.
    • Ajout au système d'intégration continue de Bazel s'il n'est pas déjà présent.
    • Compatible et aligné avec la direction du produit Bazel
  • Vérification du code. Toutes les modifications dans tous les dépôts bazelbuild nécessitent un examen :
    • Tous les PR doivent être approuvés par un propriétaire ou un responsable.
    • Seuls les propriétaires et les responsables peuvent fusionner des PR.
  • Compatibilité. Les propriétaires peuvent rejeter ou demander des modifications des PR dans le cas peu probable où la modification nécessiterait des modifications importantes des systèmes Google internes.
  • Documentation. Le cas échéant, les contributions de fonctionnalités doivent inclure des mises à jour de la documentation.

Pour en savoir plus sur la contribution à Bazel, consultez nos consignes relatives aux contributions.