Eine einzelne Issue-Vorlage für Dein Repository manuell erstellen

Du kannst in einem der unterstützten Ordner ein Unterverzeichnis ISSUE_TEMPLATE erstellen, um mehrere Issuevorlagen zu speichern. Mit dem Abfrageparameter template kannst Du die Vorlage festlegen, mit der der Issue-Text ausgefüllt werden soll. Weitere Informationen findest Du unter „Informationen zur Automatisierung für Issues und Pull Requests mit Abfrageparametern.“

Du kannst YAML-Titelei zu jeder Issuevorlage hinzufügen, um den Issuetitel vorab auszufüllen, automatisch Kennzeichnungen und Bearbeiter hinzuzufügen und der Vorlage einen Namen und eine Beschreibung zu geben, die in der Vorlagenauswahl angezeigt wird, die Personen bei Erstellen von neuen Issues in Deinem Repository sehen.

Hier ist ein Beispiel für eine YAML-Titelei.

---
name: Issue verfolgen
about: Benutzer diese Vorlage zum verfolgen neuer Funktionen.
title: "[DATE]: [FEATURE NAME]"
labels: Issue verfolgen, benötigt Bewertung
assignees: octocat
---

Um in eine Communityprofil-Checkliste aufgenommen zu werden, müssen sich Issuevorlagen im .github/ISSUE_TEMPLATE-Verzeichnis befinden und müssen gültige name: und about: YAML-Titelei-Werte beinhalten.

Du kannst Standard-Issuevorlagen und ein Standard-Konfigurationsfile für Issue-Vorlagen für Deine Organisation oder Dein Benutzerkonto erstellen. Weitere Informationen findest Du unter „Erstellen einer Standard-Community-Unterstützungsdatei."

Eine Issuevorlage hinzufügen

1. Navigiere in GitHub zur Hauptseite des Repository.
2. Klicke oberhalb der Dateiliste auf Create new file (neue Datei erstellen).
   
3. Gib Folgendes im Feld für den Dateinamen ein:
   • Wenn die Issuevorlage im Stammverzeichnis des Repositorys sichtbar sein soll, gib den Namen Deiner issue_template ein. Beispiel: issue_template.md.
     
   • Wenn die Issuevorlage im docs-Verzeichnis des Repositorys sichtbar sein soll, gib docs/ ein, gefolgt vom Namen der issue_template. Beispiel: docs/issue_template.md,
     
   • Um Deine Datei in einem ausgeblendeten Verzeichnis zu speichern, gib .github ein, gefolgt vom Namen der issue_template. Beispiel: .github/issue_template.md.
     
   • Um mehrere Issuevorlagen zu erstellen und mithilfe des Abfrageparameters template eine Vorlage zum Ausfüllen des Issue-Texts festzulegen, gib .github/ISSUE_TEMPLATE/ ein, gefolgt vom Namen der Issuevorlage. Beispiel: .github/ISSUE_TEMPLATE/issue_template.md. Du kannst auch mehrere Issuevorlagen in einem Unterverzeichnis ISSUE_TEMPLATE innerhalb des Stammverzeichnisses oder in docs/-Verzeichnissen speichern. Weitere Informationen findest Du unter „Informationen zur Automatisierung für Issues und Pull Requests mit Abfrageparametern.“
     
4. Füge im Text der neuen Datei Deine Issuevorlage hinzu. Sie könnte beispielsweise Folgendes enthalten:
   • YAML-Titelei
   • Erwartetes und tatsächliches Verhalten
   • Schritte zum Reproduzieren des Problems
   • Spezifikationen wie die Version des Projektes, das Betriebssystem oder die Hardware
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"
   
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 Master ist, solltest Du einen neuen Branch für Deinen Commit erstellen und dann einen Pull Request erstellen. Weitere Informationen findest Du unter „Erstellen eines neuen Pull Requests."
   Vorlagen sind für Mitarbeiter verfügbar, wenn sie in den Standardbranch des Repositorys gemergt wurden.
7. Klicke auf Propose new file (Neue Datei vorschlagen)
   

Weiterführende Informationen

• „Informationen zu Vorlagen für Issues und Pull Requests“
• „Issuevorlagen für Dein Repository konfigurieren"
• „Informationen zur Automatisierung für Issues und Pull Requests mit Abfrageparametern“
• „Einen Issue erstellen“