Gruppi di interesse speciale Bazel

Bazel ospita gruppi di interesse speciali (SIG) per concentrare la collaborazione su aree specifiche e supportare la comunicazione e il coordinamento tra proprietari, garanti e collaboratori di Bazel. Questo criterio si applica a bazelbuild.

I SIG svolgono il proprio lavoro in pubblico. L'ambito ideale per un SIG copre un dominio ben definito, in cui la maggior parte della partecipazione proviene dalla community. I SIG possono concentrarsi su repository gestiti dalla community in bazelbuild (ad esempio regole linguistiche) o concentrarsi su aree di codice nel repository Bazel (come Remote Execution).

Anche se non tutti i SIG avranno lo stesso livello di energia, portata o modelli di governance, dovrebbero esserci prove sufficienti che ci siano membri della comunità disposti a interagire e a contribuire secondo il gruppo di interesse stabilito. , Prima di entrare a far parte del gruppo, esamina il lavoro del gruppo e contatta il responsabile SIG. I criteri di appartenenza variano a seconda del SIG.

Consulta l'elenco completo dei Bazel SIG.

Obiettivi non confermati: cosa non è un SIG

I SIG sono destinati a facilitare la collaborazione sul lavoro condiviso. Pertanto, un SIG è:

  • Non è un forum di assistenza: una mailing list e un SIG non sono la stessa cosa
  • Non immediatamente obbligatorio: all'inizio della vita di un progetto, potresti non sapere se hai condiviso lavori o collaboratori
  • Non manodopera libera: energia richiesta per crescere e coordinare il lavoro in modo collaborativo

I proprietari di Bazel adottano un approccio prudente nella creazione di SIG. Grazie alla facilità di avvio dei progetti su GitHub, sono molti i modi in cui la collaborazione può avvenire senza la necessità di un SIG.

Ciclo di vita SIG

Questa sezione illustra come creare un SIG.

Ricerca e consulenza

Per proporre un nuovo gruppo SIG, raccogli prima le prove per l'approvazione, come specificato di seguito. Ecco alcuni possibili approcci da prendere in considerazione:

  • Un problema ben definito o una serie di problemi che il gruppo risolverà
  • Consulta i membri della community che potrebbero trarne vantaggio, valutando sia i vantaggi sia la volontà di impegnarsi
  • Per i progetti esistenti, le prove di problemi e PR che i collaboratori tengono all'argomento
  • Potenziali obiettivi che il gruppo può raggiungere
  • Requisiti delle risorse per l'esecuzione del gruppo

Anche se la necessità di un SIG sembra evidente, la ricerca e la consultazione sono ancora importanti per il successo del gruppo.

Crea il nuovo gruppo.

Il nuovo gruppo deve seguire la seguente procedura per il noleggio. In particolare, deve dimostrare:

  • Uno scopo evidente e un vantaggio per Bazel (nell'ambito di un sottoprogetto o di un'area di applicazione)
  • Due o più collaboratori disposti a agire come leader, l'esistenza di altri collaboratori e l'evidenza della domanda per il gruppo
  • Ogni gruppo deve utilizzare almeno una mailing list accessibile pubblicamente. Un SIG può riutilizzare uno degli elenchi pubblici, come bazel-discuss, chiedere un elenco per @bazel.build o creare il proprio elenco
  • Risorse richieste inizialmente dal SIG (solitamente, mailing list e videochiamate regolari).
  • I SIG possono pubblicare documenti e file dalla propria directory in bazelbuild/community o dal proprio repository nel bazelbuild organizzazione GitHub. I SIG possono essere collegati a risorse esterne se scelgono di organizzare il proprio lavoro al di fuori dell'organizzazione GitHub bazelbuild
  • I proprietari di Bazel approvano o rifiutano le applicazioni SIG e consultano altre parti interessate secondo necessità

Prima di inserire le parti formali del processo, consulta il team del prodotto Bazel, all'indirizzo product@bazel.build. La maggior parte dei SIG richiede una conversazione e un'iterazione prima dell'approvazione.

La richiesta formale per il nuovo gruppo viene inviata inviando un charter come PR al bazelbuild/community e includendo la richiesta nei commenti sul PR seguendo il modello riportato di seguito. Al momento dell'approvazione, il PR per il gruppo viene unito e le risorse richieste vengono create.

Richiesta di modello per il nuovo SIG

Per richiedere un nuovo SIG, utilizza il modello nel repository della community: SIG-request-template.md.

Noleggio

Per stabilire un gruppo, devi avere uno statuto e devi seguire il codice di condotta di Bazel. Gli archivi del gruppo saranno pubblici. L'appartenenza può essere aperta a tutti senza approvazione o disponibile su richiesta, in attesa dell'approvazione dell'amministratore del gruppo.

La carta deve nominare un amministratore. Oltre a un amministratore, il gruppo deve includere almeno una persona come responsabile (che potrebbe essere la stessa persona), che funge da punto di contatto per il coordinamento richiesto dal team di prodotto di Bazel.

Gli autori del gruppo devono pubblicare il proprio statuto nella mailing list di gruppo. Il repository della community nell'organizzazione Bazel GitHub archivia tali documenti e criteri. Man mano che i gruppi evolvono le proprie prassi e convenzioni, devono aggiornare le carte nella parte pertinente del repository della community.

Collaborazione e inclusione

Anche se non è obbligatorio, il gruppo deve scegliere di utilizzare la collaborazione tramite audioconferenze programmate o canali di chat per condurre riunioni. Le riunioni devono essere pubblicizzate nella mailing list e le note devono essere pubblicate nella mailing list in un secondo momento. Le riunioni regolari consentono di responsabilizzare e avanzare nel SIG.

I membri del team di prodotto di Bazel possono monitorare proattivamente e incoraggiare il gruppo a discutere e agire di conseguenza.

Avviare un SIG

Attività obbligatorie:

Attività facoltative:

  • Creare un post per il blog Bazel

Salute e risoluzione dei SIG

I proprietari di Bazel fanno tutto il possibile per garantire lo stato di SIG. I proprietari di Bazel a volte richiedono al lead SIG di segnalare il lavoro del SIG per informare la community di Bazel più ampia dell'attività del gruppo.

Se un SIG non ha più uno scopo utile o una community interessata, potrebbe essere archiviato e interrompere l'attività. Il team di prodotto di Bazel si riserva il diritto di archiviare tali SIG inattivi per mantenere l'integrità complessiva del progetto, anche se è un risultato meno preferibile. Un SIG può anche scegliere di sganciarlo se riconosce che ha raggiunto la fine del suo ciclo di vita utile.

Nota

Questi contenuti sono stati adottati dal playbook SIG di Tensorflow con modifiche.