Einführung
Dieser Leitfaden zeigt, wie Sie mit GitHub Issues ein Arbeitselement planen und verfolgen. In diesem Leitfaden erstellen Sie ein neues Problem. Außerdem erfahren Sie, wie Sie Bezeichnungen, Meilensteine, Zuweisende und Projekte hinzufügen, um Metadaten zu Ihrem Problem zu kommunizieren.
Voraussetzungen
Um ein Problem zu erstellen, benötigst du ein Repository. Du kannst ein vorhandenes Repository verwenden, auf das du Schreibzugriff hast, oder du kannst ein neues Repository erstellen. Im Repository müssen Issues aktiviert sein. Weitere Informationen zum Erstellen eines Repositorys findest du unter Ein neues Repository erstellen. Weitere Informationen findest du unter Issues deaktivieren, um Issues zu aktivieren, wenn sie in deinem Repository deaktiviert sind.
Öffnen eines leeren Problems
Erstelle zunächst ein Problem. Es gibt mehrere Möglichkeiten, ein Problem zu erstellen; du kannst die Methode wählen, die für deinen Workflow am besten geeignet ist. In diesem Beispiel wird die GitHub Benutzeroberfläche verwendet. Weitere Informationen zu weiteren Möglichkeiten, ein Issue zu erstellen, findest du unter Ein Problem erstellen.
-
Navigieren Sie auf GitHub zur Hauptseite des Repositorys.
-
Klicke unter dem Repositorynamen auf Issues.
-
Klicke auf Neues Issue.
-
In diesem Beispiel wird mit einem leeren Problem begonnen. Ihr Repository kann Problemvorlagen verwenden, um Mitwirkende zu ermutigen, bestimmte Informationen bereitzustellen. Wenn dein Repository Vorlagen für Probleme verwendet, klicke auf Ein leeres Problem öffnen.
Ausfüllen von Informationen
Gib deinem Problem einen beschreibenden Titel. Der Titel sollte auf einen Blick vermitteln, was das Problem betrifft.
Füge eine Beschreibung hinzu, die den Zweck des Problems erläutert, einschließlich aller Details, die das Problem möglicherweise beheben können. Wenn dies beispielsweise ein Fehlerbericht ist, beschreibe die Schritte zum Reproduzieren des Fehlers, des erwarteten Ergebnisses und des tatsächlichen Ergebnisses.
Du kannst Markdown verwenden, um Formatierungen, Links, Emojis und mehr hinzuzufügen. Weitere Informationen finden Sie unter Schreiben auf GitHub.
Hinzufügen von Abhängigkeiten zwischen Issues
Du kannst blockierende Beziehungen zwischen Problemen mithilfe von Abhängigkeiten von Problemen festlegen. Mit Issue-Abhängigkeiten kannst du Probleme identifizieren, die von anderen Aufgaben blockiert werden oder andere Aufgaben blockieren. Weitere Informationen findest du unter Erstellen von Abhängigkeiten zwischen Vorgängen.
Kommunizieren
Nachdem dein Problem erstellt wurde, kannst du die Konversation fortsetzen, indem du Kommentare zu dem Problem hinzufügst. Du kannst @mention Mitarbeiter oder Teams auf einen Kommentar aufmerksam machen. Um verwandte Issues im gleichen Repository zu verknüpfen, kannst du # gefolgt von einem Teil des Issuetitels eingeben und dann auf das Issue klicken, das du verknüpfen möchtest. Weitere Informationen finden Sie unter Schreiben auf GitHub.
Nächste Schritte
Du kannst Projekte für eine Vielzahl von Zwecken verwenden. Zum Beispiel:
- Nachverfolgen von Ideen
- Sammeln von Feedback
- Planen von Aufgaben
- Melden von Fehlern
Hier sind einige hilfreiche Ressourcen zum Ausführen der nächsten Schritte mit GitHub Issues:
- Weitere Informationen zu Problemen finden Sie unter Informationen zu Problemen.
- Weitere Informationen zu den Grundlagen für die Verwendung der Planungs- und Nachverfolgungstools von GitHub finden Sie unter Planen und Nachverfolgen von Arbeiten für dein Team oder Projekt.
- Weitere Informationen dazu, wie dir Projekte bei der Planung und Nachverfolgung helfen können, findest du unter Informationen zu Projects.
- Weitere Informationen zur Verwendung von Problemvorlagen , um Mitwirkende zur Bereitstellung bestimmter Informationen zu ermutigen, finden Sie unter Verwenden von Vorlagen zur Förderung nützlicher Issues und Pull Requests.