Norme sui contributi

Questa pagina illustra il modello di governance e la norma relativa ai contributi di Bazel.

Modello di governance

Il progetto Bazel è gestito e gestito da Google e dispone di una vasta community di collaboratori esterni a Google. Alcuni componenti di Bazel (ad esempio repository di regole specifici nell'organizzazione bazelbuild) sono gestiti, gestiti e gestiti dai membri della community. Il team di Google Bazel esamina i suggerimenti per l'aggiunta di repository di proprietà della community (ad esempio regole) all'organizzazione bazelbuild di GitHub.

Ruoli di collaboratore

Ecco uno schema dei ruoli nel progetto Bazel, comprese le relative responsabilità:

  • Proprietari: il team di Google Bazel. I proprietari sono responsabili di:
    • Strategia, manutenzione e leadership per il progetto Bazel.
    • Creazione e manutenzione delle funzionalità principali di Bazel.
    • Nomina dei manutentori e approvazione di nuovi repository.
  • Manutenzione: il team di Google Bazel e gli utenti GitHub designati. I manutentori sono responsabili di:
    • Creazione e gestione della funzionalità principale del repository.
    • Revisione e approvazione di contributi nelle aree della base di codice Bazel.
    • Assistenza a utenti e collaboratori per la gestione tempestiva e trasparente dei problemi, la revisione PR e la documentazione.
    • Rilascio, test e collaborazione con i proprietari di Bazel.
  • Collaboratori: tutti gli utenti che contribuiscono al codice o alla documentazione di Baazel.
    • Creazione di PR ben scritte per contribuire al codebase e alla documentazione di Bazel.
    • Utilizzo di canali standard, ad esempio Problemi GitHub, per proporre modifiche e segnalare problemi.

Diventare manutentore

I proprietari di Bazel possono nominare manutentori a gestire aree di codice ben definite, come i set di regole. I collaboratori con un'indicazione di contributi passati coerenti e responsabili che pianificano importanti contributi in futuro potrebbero essere considerati manutentori qualificati.

Norme sui contributi

Il progetto Bazel accetta contributi di collaboratori esterni. Ecco le norme sui contributi per le aree di codice gestite da Google e dalla community.

  • Licenze. Tutti i manutentori e i collaboratori devono firmare il Contratto di licenza di Google Contributor.
  • Contributi. I proprietari e i manutentori dovrebbero fare il possibile per accettare contributi interessanti. Tutti i contributi devono essere:
    • Scrivere bene e ben testato
    • Illustrati e approvati dai manutentori dell'area di codice pertinente. Discussioni e approvazioni si verificano nei problemi di GitHub e nelle PR GitHub. Per contributi più ampi, è richiesta una revisione del design.
    • Se non è già presente, è stato aggiunto al sistema di integrazione continua di Bazel.
    • Supportata e allineata alle indicazioni dei prodotti Bazel
  • Revisione del codice. Tutte le modifiche in tutti i repository bazelbuild richiedono una revisione:
    • Tutti i PR devono essere approvati da un proprietario o manutentore.
    • Solo i proprietari e i manutentori possono unire i PR.
  • Compatibilità. I proprietari potrebbero dover rifiutare o richiedere modifiche ai PR nell'improbabile caso in cui la modifica richieda modifiche sostanziali ai sistemi interni di Google.
  • Documentazione. Se pertinente, i contributi alle funzionalità devono includere aggiornamenti della documentazione.

Per maggiori dettagli su come contribuire a Bazel, consulta le nostre linee guida per i contributi.