Hallo, Entdecker! An dieser Seite wird aktiv gearbeitet, oder sie wird noch übersetzt. Die neuesten und genauesten Informationen findest Du in unserer englischsprachigen Dokumentation.

Diese Version von GitHub Enterprise wird eingestellt am Diese Version von GitHub Enterprise wurde eingestellt am 2020-08-20. Es wird keine Patch-Freigabe vorgenommen, auch nicht für kritische Sicherheitsprobleme. Für eine bessere Leistung, verbesserte Sicherheit und neue Features nimm ein Upgrade auf die neueste Version von GitHub Enterprise vor. Wende Dich an den GitHub Enterprise-Support, um Hilfe beim Upgrade zu erhalten.

Artikelversion: Enterprise Server 2.18

Richtlinien für Repository-Mitarbeiter festlegen

Du kannst Richtlinien erstellen, wie Personen zu Deinem Projekt beitragen sollten.

Inhalt dieses Artikels

Um die Beiträge Deiner Projektmitarbeiter zu optimieren, kannst Du ein Dokument mit Beitragsrichtlinien in das Stammverzeichnis, in das Verzeichnis docs oder in das Verzeichnis .github Deines Projekt-Repositorys hinzufügen. Bei der Eröffnung eines Pull Requests oder der Erstellung eines Issues wird dem betreffenden Mitarbeiter dann ein Link zu dieser Datei angezeigt.

Beitragsrichtlinien

Für den Repositoryinhaber stellen Beitragsrichtlinien eine Möglichkeit dar, Mitarbeitern die Regeln für Beiträge zu kommunizieren.

Mitarbeitern helfen die Richtlinien, korrekt formulierte Pull Requests einzureichen und sinnvolle Issues zu eröffnen.

Sowohl Inhaber als auch Mitarbeiter sparen dank Beitragsrichtlinien Zeit und Mühen, die durch fehlerhaft formulierte Pull Requests oder Issues entstehen, die abgelehnt und erneut eingereicht werden müssen.

Du kannst Standard-Beitragsrichtlinien für Deine Organisation erstellen. Weitere Informationen findest Du unter „Ein Standard-Community-Unterstützungsdatei erstellen."

Tipp: Repository-Betreuer können mit Vorlagen für Issues oder Pull Requests spezifische Richtlinien für ihr Repository einrichten. Weitere Informationen findest Du unter „Informationen zu Vorlagen für Issues und Pull Requests.“

CONTRIBUTING-Datei hinzufügen

  1. Navigiere in GitHub Enterprise zur Hauptseite des Repository.

  2. Above the list of files, click Create new file.

    "Create new file" button

  3. Entscheide, ob die Beitragsrichtlinien im Stammverzeichnis, im Verzeichnis docs oder im Verzeichnis .github Deines Repositorys gespeichert werden sollen. Gib danach im Feld „Filename“ (Dateiname) den Namen und die Erweiterung der Datei ein. In Dateinamen von Beitragsrichtlinien wird die Groß-/Kleinschreibung ignoriert, und die Dateien können die Erweiterung .md oder .txt haben.

    Neuer Dateiname

    • Wenn Deine Beitragsrichtlinien im Stammverzeichnis Deines Repositorys erscheinen sollen, gib CONTRIBUTING ein.
    • Wenn Deine Beitragsrichtlinien im Verzeichnis docs Deines Repositorys erscheinen sollen, gib zur Erstellung des neuen Verzeichnisses docs/ ein und anschließend CONTRIBUTING.
  4. Füge der neuen Datei Beitragsrichtlinien hinzu. Diese könnten beinhalten:

    • Schritte zur Erstellung korrekt formulierter Issues oder Pull Requests.
    • Links zu externer Dokumentation, zu Verteilerlisten oder zu einem Verhaltenskodex.
    • Erwartungen der Community und Verhaltensregeln
  5. Am Ende der Seite schreibe eine kurze, aussagekräftige Commit-Mitteilung, welche die Änderung beschreibt, welche Du an der Datei vornimmst. Du kannst den Commit in der Commit-Mitteilung mehr als einem Autor zuordnen. Weitere Informationen findest Du unter "Erstellen eines Commit mit mehreren Co-Autoren"

    Commit-Mitteilung für Ihre Änderung

  6. Lege unter den Commit-Mitteilungsfeldern fest, ob Du Dein Commit zum aktuellen Branch oder zu einem neuen Branch hinzufügen möchten. If your current branch is the default branch, you should choose to create a new branch for your commit and then create a pull request. Weitere Informationen findest Du unter „Erstellen eines neuen Pull Requests."

    Branch-Optionen für Commit

  7. Klicke auf Propose new file (Neue Datei vorschlagen)

    Schaltfläche "Propose new file" (Neue Datei vorschlagen)

Beispiele für Beitragsrichtlinien

Wenn Du nun nicht sicher bist, was Du hier festlegen sollst, findest Du nachfolgend einige gute Beispiele für Beitragsrichtlinien:

Weiterführende Informationen

Menschliche Unterstützung einholen

Du kannst das Gesuchte nicht finden?

Kontakt