Groupes d'intérêt particuliers de Bazel

Bazel héberge des groupes d'intérêts particuliers (SIG, Special Interest Groups) pour concentrer la collaboration sur certains domaines, et permettre la communication et la coordination entre les propriétaires, gestionnaires et contributeurs Bazel. Cette règle s'applique à bazelbuild.

Les SIG font leur travail en public. Le champ d'application idéal d'un SIG couvre un domaine bien défini, dans lequel la majorité provient de la communauté. Les SIG peuvent se concentrer sur les dépôts gérés par la communauté dans bazelbuild (tels que les règles de langage) ou sur des zones de code dans le dépôt Bazel (telles que l'exécution à distance).

Bien que tous les SIG ne disposent pas du même niveau d'énergie, de portée ou de gouvernance, il doit y avoir suffisamment de preuves que des membres de la communauté sont prêts à s'engager et à contribuer si le groupe d'intérêt est établi (Installation de Python groupée). Avant de rejoindre le groupe, examinez le travail du groupe, puis contactez le responsable du SIG. Les règles concernant les adhésions varient en fonction des SIG.

Consultez la liste complète des SIG Bazel.

Non-objectifs: absence d'objectif SIG

Les SIG sont destinés à faciliter la collaboration sur le travail partagé. Par conséquent:

  • Il ne s'agit pas d'un forum d'assistance:une liste de diffusion et un SIG sont deux choses différentes.
  • Pas immédiatement:dès le début de la vie d'un projet, vous ne saurez peut-être pas si vous avez partagé un travail ou des collaborateurs.
  • Travail non libre:l'énergie est nécessaire pour développer et coordonner le travail de manière collaborative.

Les propriétaires de Bazel adoptent une approche prudente de la création de SIG. Grâce à la facilité de démarrage des projets sur GitHub, de nombreuses possibilités s'offrent à eux pour permettre la collaboration sans avoir besoin d'un SIG.

Cycle de vie des SIG

Cette section explique comment créer un SIG.

Recherche et conseil

Pour proposer un nouveau groupe SIG, commencez par recueillir des preuves pour approbation, comme indiqué ci-dessous. Voici quelques pistes possibles:

  • Problème bien défini ou ensemble de problèmes que le groupe pourrait résoudre
  • Consultation de membres de la communauté qui pourraient tirer parti pour évaluer à la fois les avantages et le degré d'engagement
  • Pour les projets existants, preuves de problèmes et de relations publiques qui font évoluer le sujet
  • Objectifs potentiels pour le groupe
  • Ressources nécessaires à l'exécution du groupe

Même si le besoin d'un SIG semble évident, les recherches et les conseils associés sont tout de même importants pour la réussite du groupe.

Créer le groupe

Le nouveau groupe doit suivre la procédure ci-dessous pour la location. Il doit en particulier démontrer:

  • un objectif et des avantages clairs pour Bazel (autour d'un sous-projet ou d'une zone d'application) ;
  • Au moins deux contributeurs prêts à agir en tant que responsables de groupe, existence d'autres contributeurs et preuve de la demande pour le groupe
  • Chaque groupe doit utiliser au moins une liste de diffusion publique. Un SIG peut réutiliser l'une des listes publiques, telle que bazel-discuss, demander une liste pour @bazel.build ou créer sa propre liste.
  • Ressources initialement requises par le SIG (liste de diffusion et appel vidéo standard en général)
  • Les SIG peuvent diffuser des documents et des fichiers depuis leur répertoire dansbazelbuild/community Ou dans leur propre dépôt dansbazelbuild Organisation GitHub. Les SIG peuvent être associés à des ressources externes s'ils choisissent d'organiser leur travail en dehors de l'organisation GitHub bazelbuild
  • Les propriétaires de Bazel approuvent ou refusent les applications SIG et consultent d'autres personnes concernées, si nécessaire.

Avant d'entrer dans les étapes officielles du processus, contactez l'équipe produit Bazel à l'adresse product@bazel.build. La plupart des SIG nécessitent une conversation et une itération avant l'approbation.

La demande formelle pour le nouveau groupe s'effectue en envoyant une charte de relations publiques à bazelbuild/community, et en incluant la demande dans les commentaires sur les relations publiques suivant le modèle{101. }ci-dessous. Après approbation, le rapport de ressources du groupe est fusionné avec les ressources requises créées.

Modèle de requête pour le nouvel SIG

Pour demander un nouveau SIG, utilisez le modèle du dépôt de la communauté : SIG-request-template.md.

Affrètement

Pour établir un groupe, vous devez disposer d'une charte et respecter le code de conduite Bazel. Les archives du groupe seront publiques. L'abonnement peut être ouvert à tous sans approbation ou disponible sur demande, en attendant l'approbation de l'administrateur du groupe.

La charte doit désigner un administrateur. En tant qu'administrateur, le groupe doit inclure au moins une personne en tant que responsable (il peut s'agir de la même personne), qui sert de point de contact pour la coordination, conformément à la demande de l'équipe produit Bazel.

Les créateurs de groupes doivent publier leur charte dans la liste de diffusion du groupe. Le dépôt de la communauté dans l'organisation GitHub de Bazel archive ces documents et stratégies. À mesure que les groupes évoluent leurs pratiques et leurs conventions, ils doivent mettre à jour leurs chartes dans la section appropriée du dépôt de la communauté.

Collaboration et inclusion

Même si ce n'est pas obligatoire, le groupe doit choisir de recourir à la collaboration via des conférences téléphoniques ou des canaux de chat pour mener des réunions. Ce type de réunion doit faire l'objet d'annonces sur la liste de diffusion et de notes publiées ultérieurement. Des réunions régulières permettent d'assurer la responsabilité et de progresser dans le cadre d'un SIG.

Les membres de l'équipe produit Bazel peuvent surveiller et encourager le groupe de manière proactive à la discussion et à l'action, le cas échéant.

Lancer un SIG

Activités requises:

Activités facultatives:

  • Créer un article pour le blog Bazel

Santé et cessation des SIG

Les propriétaires de Bazel mettent tout en œuvre pour garantir l'état des SIG. Les propriétaires de Bazel demandent parfois à ce que le responsable SIG génère des rapports sur le travail de SIG afin d'informer l'ensemble de la communauté Bazel sur l'activité du groupe.

Si un SIG n'a plus d'utilité ni de communauté intéressée, il peut être archivé et cesser son fonctionnement. L'équipe produit de Bazel se réserve le droit d'archiver ces SIG inactifs pour préserver l'état général du projet, bien qu'il s'agisse d'un résultat moins privilégié. Un SIG peut également choisir de se désengager s'il a atteint la fin de sa vie utile.

Remarque

Ce contenu a été adopté selon les modifications apportées au playbook SIG de TensorFlow.