Schnellstart für Aufgabenlisten

Einführung

In diesem Leitfaden wird veranschaulicht, wie du Aufgabenlisten verwendest, um eine größere Aufgabe in mehrere Aufgabenlisten und mehrere Teilaufgaben aufzuteilen. Du erfährst, wie du eine Aufgabenliste über die Benutzeroberfläche erstellst, eine Aufgabenliste mit Markdown-Code erstellst, Änderungen an einer Aufgabenliste vornimmst und deine neue Aufgabenlisten in ein Projekt integrierst.

Um zu veranschaulichen, wie Aufgabenlisten verwendet werden können, um Aufgaben in kleinere Teilaufgaben aufzuteilen, wird in diesem Leitfaden ein Szenario verwendet, in dem du eine Landing Page für ein neues Feature erstellen musst. Befolge diesen Leitfaden, aber integriere dein eigenes Szenario.

Voraussetzungen

Wenn du diesen Leitfaden befolgst, erstellst du mehrere Issues in einem Repository. Du benötigst ein Repository, in dem du Issues erstellen kannst.

Erstellen eines Issues zum Nachverfolgen der Arbeit beim Hinzufügen einer neuen Landing Page

In diesem Schritt erstellst du das übergeordnete Issue, um die Teilaufgaben nachzuverfolgen, die zum Veröffentlichen der neuen Landing Page erforderlich sind.

1. Navigiere zu dem Repository, in dem du die Arbeit nachverfolgen möchtest.
2. Erstelle ein neues leeres Issue namens „Tracking issue for landing page“. Weitere Informationen findest du unter Einen Issue erstellen.

Erstellen der ersten Aufgabenliste

Aufgabenlisten werden dem Eröffnungskommentar eines Issues (der Beschreibung des Issues) hinzugefügt. Issues können mehrere Aufgabenlisten mit unterschiedlichen Namen enthalten. Dies ist eine hervorragende Möglichkeit, deine Teilaufgaben zu kategorisieren.

1. Wechsle zu dem soeben erstellten Issue. Wenn du dies noch nicht getan hast, klicke auf Neues Issue übermitteln.
2. Klicke unten in der Issuebeschreibung auf Aufgabenliste hinzufügen.

Dadurch wird eine leere Aufgabenliste in dein Issue eingefügt.

Hinzufügen von Aufgabenentwürfen

Aufgabenentwürfe sind Textelemente, die deiner Aufgabenliste hinzugefügt werden. Aufgabenentwürfe werden in deiner Aufgabenliste mit einem Kontrollkästchen angezeigt. Du kannst Aufgabenentwürfe verwenden, um die Anforderungen und Teilaufgaben für dein Projekt schnell zu skizzieren und ggf. später in Issues umzuwandeln.

1. Wenn das Textfeld noch nicht fokussiert ist, klicke auf Element zu Aufgaben hinzufügen.

   

2. Füge einige Aufgabenentwürfe hinzu, um diesen Arbeitsschritt zu skizzieren. Gib den Aufgabenentwurf ein, und drücke dann jeweils die EINGABETASTE.

   Für das Beispielszenario für die Landing Page kannst du Folgendes hinzufügen:

   • „Design new landing page“
   • „Create content for landing page“
   • „Translate content into supported languages“

Umwandeln eines Aufgabenentwurfs in ein Issue

Du kannst Aufgabenentwürfe in Issues umwandeln. Du kannst Aufgabenentwürfe umwandeln, wenn du bereit bist, mit der Arbeit an einer bestimmten Aufgabe zu beginnen. Die Issues werden in dem Repository erstellt, das du für dein Nachverfolgungsissue verwendet hast.

1. Klicke neben dem Aufgabenentwurf „Design new landing page“auf .

   

2. Klicke auf In Issue konvertieren.

Selbstzuweisung des neuen Issues

Du kannst dir das neue Issue jetzt selbst zuweisen, ohne deine Aufgabenliste zu verlassen.

1. Klicke neben dem Issue „Design new landing page“ in deiner Aufgabenliste auf .

   

2. Klicke im Kontextmenü auf Zugewiesene Personen festlegen.

3. Wähle in der Liste der Personen dich selbst aus.

Du kannst dieses Kontextmenü auch verwenden, um Bezeichnungen festzulegen und einem Projekt ein Issue hinzuzufügen.

Umbenennen einer Aufgabenliste

Du kannst den Namen einer Aufgabenliste ändern, um die von ihr nachverfolgten Aufgaben besser darzustellen. Dies ist besonders nützlich, wenn in einem Issue mehrere Aufgabenliste vorhanden sind und du die Aufgaben segmentieren möchtest.

1. Wähle rechts oben in deiner Aufgabenliste aus.

   

2. Klicke im Menü auf Umbenennen.

3. Gib einen neuen Namen für die Aufgabenliste ein, und drücke die EINGABETASTE.

   Im Beispielszenario für die Landing Page könnest du diese Aufgabenliste in „Landing page content“ umbenennen.

Erstellen einer zweiten Aufgabenliste mithilfe von Markdown-Code

Du kannst mehrere Aufgabenlisten in einem einzelnen Issue erstellen. Jede Aufgabenliste weist eigene Aufgaben und einen eigenen Namen auf. Du kannst Aufgabenlisten mithilfe der Schaltfläche Aufgabenliste hinzufügen oder durch die Eingabe von Markdown-Code beim Bearbeiten des Issues hinzufügen.

1. Klicke oben in der Issuebeschreibung (Eröffnungskommentar) auf .

   

2. Klicke im Menü auf Bearbeiten.

3. Füge in der Issuebeschreibung unterhalb der ersten Aufgabenliste den folgenden Markdown-Code hinzu:

   Markdown

   ```[tasklist]
   ### Tasks
   - [ ] Draft task
   ```
   

4. Um den Namen dieser Aufgabenliste zu ändern, gib nach ### einen neuen Namen ein. Ändere beispielsweise ### Tasks in ### Backend changes.

In den nächsten beiden Abschnitten nimmst du weitere Änderungen am Markdown-Code vor, bevor du den Kommentar speicherst.

Hinzufügen von Aufgabenentwürfen mithilfe von Markdown-Code

Du kannst schnell neue Aufgabenentwürfe hinzufügen, indem du sie einfach direkt mit Markdown-Code in deiner Aufgabenliste eingibst.

1. Füge neue Aufgabenentwürfe hinzu, indem du nach der letzten Aufgabe eine neue Zeile erstellst und dann - [ ] sowie die neue Aufgabe eingibst. Beispiel: - [ ] Sign-up form.
2. Bearbeite einen vorhandenen Aufgabenentwurf, indem du den Text nach - [ ] änderst. Ändere beispielsweise - [ ] Draft task in - [ ] Database schema.

Hinzufügen vorhandener Issues mithilfe von Markdown-Code

Du kannst auch vorhandene Issues nachverfolgen, indem du sie deiner Aufgabenliste hinzufügst. Du kannst vorhandene Issues mithilfe von Markdown-Code oder über die Benutzeroberfläche durch Einfügen der Issue-URL hinzufügen. Du kannst Issues und Pull Requests aus jedem Repository hinzufügen, auf das du Zugriff hast.

1. Gib zunächst - [ ] in einer neuen Zeile ein, und füge dann die vollständige URL eines Issues ein. Zum Beispiel, - [ ] https://github.com/octo-org/octo-repo/issues/45
2. Klicke auf Kommentar aktualisieren.

Die neue zweite Aufgabenliste wird unter der ersten Aufgabenliste angezeigt.

Nachverfolgung des Verlaufs

Aufgabenlisten helfen dir dabei, den Status und Fortschritt der Aufgaben schnell anzuzeigen, die du zur Nachverfolgung ausgewählt hast.

1. Aktiviere links neben einem deiner Aufgabenentwürfe das Kontrollkästchen, um diese Aufgabe als erledigt zu markieren.
2. Klicke auf das Issue, das du zuvor aus einem Entwurf umgewandelt hast.
3. Klicke im umgewandelten Issue unten auf der Seite auf Issue schließen.

Wenn du zu deiner Aufgabenliste zurückkehrst und die Seite aktualisierst, wird angezeigt, dass das soeben geschlossene Issue jetzt ein Symbol aufweist, das angibt, dass es geschlossen ist. Oben im Issue wird unterhalb des Namens der Fortschritt mit „2 von 6 Aufgaben“ angegeben.

Integrieren in ein Projekt

Die Beziehungen, die du in deinen Aufgabenlisten erstellst, sind in deinen Projekten verfügbar. Du kannst den Fortschritt der einzelnen Issues anzeigen, die Teilaufgaben durchsuchen und Ansichten einrichten, die deine Aufgabenlisten verwenden.

1. Navigiere zu einem Projekt, das sich im Besitz desselben Benutzer- oder Organisationskontos befindet, das du für deine Aufgabenliste und Issues verwendet hast. Wenn kein Projekt verfügbar ist, kannst du eines erstellen. Weitere Informationen findest du unter Erstellen eines projects.

2. Erstelle eine neue Ansicht in deinem Projekt mithilfe des Tabellenlayouts. Weitere Informationen zu Ansichten findest du unter Verwalten deiner Ansichten.

3. Füge deinem Projekt eines der Issues aus deinen Aufgabenlisten hinzu. Weitere Informationen zum Hinzufügen von Elementen zu Projekten findest du unter Hinzufügten von Elementen zu deinem project.

4. Klicke neben Namen der aktuell geöffneten Ansicht auf .

   

5. Klicke im Menü auf Gruppieren nach, und wähle dann Nachverfolgt von aus. Dadurch wird eine Ansicht erstellt, in der deine Issues nach dem Issue gruppiert werden, das sie nachverfolgt.

Issues und Pull Requests werden einem Projekt nicht automatisch hinzugefügt, wenn sie einer Aufgabenliste hinzugefügt werden. Wenn du eine Ansicht nach dem Feld „Nachverfolgt von“ gruppierst, wirst du von GitHub aufgefordert, weitere Issues hinzuzufügen, die der Aufgabenliste zugeordnet sind.

1. Wenn in deinen Aufgabenlisten Issues vorhanden sind, die nicht Teil deines Projekts sind, kannst du unter der Gruppe auf 1 Element nicht in diesem Projekt klicken.

1. Klicke in der Liste mit Issues auf das Issue, das du hinzufügen möchtest. Wenn du über mehrere Issues verfügst, kannst du alle hinzufügen.

Schlussbemerkung

Unter Berücksichtigung dieses Leitfadens hast du ein Nachverfolgungsissue mit zwei Aufgabenlisten erstellt, Änderungen an diesen Aufgabenlisten über die Benutzeroberfläche und direkt mithilfe von Markdown-Code vorgenommen, einen Aufgabenentwurf in ein Issue umgewandelt und deine Aufgabenlistendaten in ein Projekt integriert.

Weitere Informationen zum Verwalten der Elemente in deiner Aufgabenliste findest du unter Verwalten von Aufgaben in einer Aufgabenliste. Weitere Informationen zum Integrieren von Aufgabenlisten in deine Projekte findest du unter Verwenden von Projekten und Aufgabenlisten.