Beitragsrichtlinie

Auf dieser Seite werden das Governance-Modell und die Beitragsrichtlinie von Bazel erläutert.

Governance-Modell

Das Bazel-Projekt wird von Google geleitet und verwaltet und hat eine große Community von Beitragenden außerhalb von Google. Einige Bazel-Komponenten (z. B. bestimmte Regel-Repositories in der Organisation bazelbuild) werden von Mitgliedern der Community geleitet, gewartet und verwaltet. Das Google Bazel-Team prüft die Vorschläge zum Hinzufügen von Community-Repositories (z. B. Regeln) zur GitHub-Organisation bazelbuild.

Beitragende Rollen

Im Folgenden sind die Rollen im Bazel-Projekt einschließlich ihrer Verantwortlichkeiten umrissen:

  • Owners (Inhaber): das Google Bazel-Team. Für Folgendes ist der Inhaber verantwortlich:
    • Strategie, Wartung und Führungsqualitäten des Bazel-Projekts
    • Kernfunktion von Bazel erstellen und verwalten
    • Administratoren verwalten und neue Repositories genehmigen.
  • Keeper: Das Google Bazel-Team und die angegebenen GitHub-Nutzer. Administratoren sind für Folgendes verantwortlich:
    • Die primäre Funktion ihres Repositorys erstellen und verwalten
    • Beiträge zu Bereichen der Bazel-Codebasis prüfen und genehmigen
    • Wir unterstützen Nutzer und Beitragende mit einem zeitnahen und transparenten Problemmanagement, einer PR-Überprüfung und Dokumentation.
    • Freigabe, Testen und Zusammenarbeit mit Bazel-Inhabern.
  • Mitwirkende: Alle Nutzer, die Code oder Dokumentation zum Bazel-Projekt beitragen.
    • Erstellen Sie gut verfasste PRs, um zur Codebasis und Dokumentation von Bazel zu beitragen.
    • Standardkanäle wie GitHub-Probleme verwenden, um Änderungen vorzuschlagen und Probleme zu melden

So werden Sie Administrator

Bazel-Inhaber können für die Durchführung klar definierter Codebereiche, z. B. Regelsätze, bestimmen. Beitragende mit einem konsistenten, verantwortungsvollen Inhalt, der in der Zukunft größere Beiträge plant, können als qualifizierte Wartungsführer eingestuft werden.

Beitragsrichtlinie

Im Bazel-Projekt werden Beiträge externer Beitragende akzeptiert. Dies sind die Beitragsrichtlinien für von Google und Community verwaltete Codebereiche.

  • Lizenzierung Alle Beauftragten und Beitragende müssen die Google-Lizenzvereinbarung für Beitragende unterzeichnen.
  • Beiträge: Inhaber und Administratoren sollten sich bemühen, rentable Beiträge zu akzeptieren. Alle Beiträge müssen folgende Voraussetzungen erfüllen:
    • Gut geschrieben und gut getestet
    • Erörtert und genehmigt von den Administratoren des relevanten Codebereichs Diskussionen und Genehmigungen finden Sie bei GitHub-Problemen und in GitHub-PRs. Größere Beiträge erfordern eine Designüberprüfung.
    • Sie wurden dem Continuous Integration-System von Bazel hinzugefügt, falls nicht bereits vorhanden.
    • Unterstützt und auf die Produktrichtung von Bazel abgestimmt
  • Codeüberprüfung. Alle Änderungen in allen bazelbuild-Repositories müssen überprüft werden:
    • Alle PRs müssen von einem Inhaber oder Administrator verwaltet werden.
    • Nur Inhaber und Administratoren können PRs zusammenführen.
  • Kompatibilität Inhaber müssen im unwahrscheinlichen Fall, dass die Änderung wesentliche Änderungen an internen Google-Systemen erfordert, Änderungen an PRs ablehnen oder anfordern.
  • Dokumentation. Sofern relevant, sollten Funktionsbeiträge Dokumentationsupdates enthalten.

Weitere Informationen zum Beitragen zu Bazel finden Sie in unseren Richtlinien für Beiträge.