Richtlinien für Repository-Mitarbeiter festlegen

Informationen zu Beitragsrichtlinien

Um deine Projektmitarbeiter bei ihrer Arbeit zu unterstützen, kannst du dem Stammverzeichnis, dem Verzeichnis docs oder dem Verzeichnis .github deines Projektrepositorys ein Dokument mit Beitragsrichtlinien 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.

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.

Sie können Standardbeitragsrichtlinien für Ihre Organisation oder Ihr persönliches Konto erstellen. Weitere Informationen finden Sie unter Erstellen einer Standard-Community-Health-File.

Hinzufügen einer Datei CONTRIBUTING

1. Navigieren Sie auf GitHub zur Hauptseite des Repositorys.

2. Klicke oberhalb der Dateiliste im Dropdownmenü Datei hinzufügen auf Neue Datei erstellen.

3. Entscheide, ob deine 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. Bei Dateinamen für Beitragsrichtlinien wird die Groß-/Kleinschreibung nicht berücksichtigt. Dateien werden im Rich-Text-Format gerendert, wenn die Dateierweiterung einem unterstützten Format entspricht. Weitere Informationen finden Sie unter Working with non-code files (Arbeiten mit anderen Dateien als Codedateien).

   • Um deine Beitragsrichtlinien im Stammverzeichnis deines Repositorys sichtbar zu machen, gib CONTRIBUTING ein.
   • Um deine Beitragsrichtlinien im Verzeichnis docs deines Repositorys sichtbar zu machen, gib docs/ ein, um das neue Verzeichnis zu erstellen, um gibt dann_CONTRIBUTING_ ein.
   • Enthält ein Repository mehrere CONTRIBUTING-Dateien, wird die in Links angezeigte Datei in der folgenden Reihenfolge aus den Speicherorten ausgewählt: Zuerst wird das .github-Verzeichnis, dann das Stammverzeichnis des Repositorys und schließlich das docs-Verzeichnis berücksichtigt.

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. Gib im Feld „Commitnachricht“ eine kurze, aussagekräftige Commitnachricht ein, die die Änderung beschreibt, die Du an der Datei vorgenommen hast. Du kannst den Commit in der Commit-Mitteilung mehr als einem Autor zuordnen. Weitere Informationen findest du unter Einen Commit mit mehreren Autoren erstellen.

6. Lege unter den Commit-Mitteilungsfeldern fest, ob Du Dein Commit zum aktuellen Branch oder zu einem neuen Branch hinzufügen möchten. Wenn dein aktueller Branch als Standardbranch festgelegt ist, solltest du einen neuen Branch für deinen Commit und dann einen Pull Request erstellen. Weitere Informationen findest du unter Erstellen eines Pull Requests.

   

7. Klicke auf Änderungen committen oder Änderungen 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:

• Die Beitragsrichtlinien für GitHub Docs
• Die Beitragsrichtlinien für Ruby on Rails.
• Die Beitragsrichtlinien von Open Government.

Weiterführende Themen

• Abschnitt Starten eines Open-Source-Projekts in den Open-Source-Leitfäden
• Eine Lizenz zu einem Repository hinzufügen