Nachdem Du in Deinem Repository Vorlagen für Issues und Pull Requests erstellt hast, können Mitarbeiter die Vorlagen verwenden, um Issues zu öffnen oder vorgeschlagene Änderungen in ihren Pull Requests gemäß den Beitragsrichtlinien des Repositorys zu beschreiben. Weitere Informationen zum Hinzufügen von Beitragsrichtlinien zu einem Repository findest Du unter „Richtlinien für Repository-Mitarbeiter festlegen.“
You can create default issue and pull request templates for your organization or user account. Weitere Informationen findest Du unter „Eine Standard-Community-Unterstützungsdatei erstellen."
Vorlagen für Issues
When you create issue templates for your repository using the issue template builder, contributors can select the appropriate template when they open new issues in the repository.
Issue templates are helpful when you want to provide guidance for opening issues while allowing contributors to specify the content of their issues.
Mit dem Vorlagengenerator kannst Du für jede Vorlage einen Titel und eine Beschreibung angeben, den Vorlageninhalt hinzufügen und einen Commit der Vorlage auf dem Standardbranch durchführen oder einen Pull Request im Repository öffnen. Der Vorlagengenerator fügt automatisch das YAML-Titelei-Markup hinzu, das erforderlich ist, damit die Vorlage auf der „Neuer Issue"-Seite angezeigt wird. Weitere Informationen findest Du unter „Issuevorlagen für Dein Repository konfigurieren.“
Du kannst die Issue-Vorlagenauswahl anpassen, die Personen sehen, wenn sie einen neuen Issue in Deinem Repository erstellen, indem Du eine config.yml-Datei zum .github/ISSUE_TEMPLATE
-Verzeichnis hinzufügst. Weitere Informationen findest Du unter „Issuevorlagen für Dein Repository konfigurieren."
Issue-Vorlagen werden auf dem Standardbranch des Repositorys in einem verborgenen .github/ISSUE_TEMPLATE
-Verzeichnis gespeichert. Wenn Sie eine Vorlage in einem anderen Branch erstellen, steht sie Mitarbeitern nicht zur Verfügung. Issue template filenames are not case sensitive, and need a .md extension. 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.
Es ist möglich, manuell eine einzelne Issue-Vorlage in Markdown mit dem Workflow für ältere Issue-Vorlagen zu erstellen, wobei die Projektmitarbeiter automatisch den Inhalt der Vorlage im Issue-Text sehen. However, we recommend using the upgraded multiple issue template builder to create issue templates. Weitere Informationen zum veralteten Workflow finden Sie unter „Eine einzelne Issue-Vorlage für Ihr Repository manuell erstellen“.
Vorlagen für Pull-Requests
Wenn Sie eine Pull-Request-Vorlage zu Ihrem Repository hinzufügen, sehen Projektmitarbeiter automatisch den Inhalt der Vorlage im Text des Pull Requests.
Vorlagen müssen Sie auf dem Standardbranch des Repositorys erstellen. Vorlagen, die in anderen Branches erstellt wurden, stehen Mitarbeitern nicht zur Verfügung. Sie können Ihre Vorlage für Pull Requests im sichtbaren Stammverzeichnis des Repositorys, im Ordner docs
oder im verborgenen Verzeichnis .github
speichern. Bei den Dateinamen von Pull-Request-Vorlagen wird nicht zwischen Groß- und Kleinschreibung unterschieden, und es kann eine .md- oder .txt-Erweiterung angefügt werden.
Weitere Informationen finden Sie unter „Eine Pull-Request-Vorlage für Ihr Repository erstellen“.