Schnellstart für GitHub Probleme

Befolge diesen kurzen interaktiven Leitfaden, um mehr über GitHub Issues zu erfahren.

In diesem Artikel

Einführung

Dieser Leitfaden zeigt, wie du GitHub Issues verwendest, um eine Arbeit zu planen und zu verfolgen. In dieser Anleitung erstellen Sie ein neues Problem. Außerdem erfährst du, wie du Bezeichnungen, Meilensteine, zugewiesene Personen und Projekte hinzufügst, um Metadaten zu deinem Issue 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. Das Repository muss Probleme aktiviert haben. 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. Dieses Beispiel verwendet die GitHub Benutzeroberfläche. Weitere Informationen zu weiteren Möglichkeiten, ein Issue zu erstellen, findest du unter Ein Problem erstellen.

  1. Navigieren Sie auf GitHub zur Hauptseite des Repositorys.

  2. Klicke unter dem Repositorynamen auf Issues.

    Screenshot der Hauptseite eines Repositorys. In der horizontalen Navigationsleiste ist eine Registerkarte mit der Bezeichnung „Issues“ dunkelorange umrandet.

  3. Klicke auf Neues Issue.

  4. In diesem Beispiel wird mit einem leeren Problem begonnen. Dein Repository kann Issue-Vorlagen verwenden, um Mitwirkende zu ermutigen, spezifische 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.

Screenshot: Formular für neues Issue mit angegebenem Titel und Text

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.

Screenshot eines Issue-Kommentars. In der Kopfzeile steht „Octocat hat gerade kommentiert.“, und der Text lautet „@hubot Müssen wir auch die Raketenlogik aktualisieren?“.

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 findest du einige hilfreiche Ressourcen für deine nächsten Schritte mit GitHub Issues: