11 — Issues, Projekte und Wiki
Alles, was kein Code ist — Aufgaben, Fehler, Entscheidungen und Notizen — liegt ebenfalls im Repository.
Ein Issue eröffnen
- Im Repository: Issues → Neues Issue.
- Titel — das Problem oder der Wunsch in einem Satz: Anmeldeseite verrutscht auf dem Handy.
- Beschreibung — was Sie erwartet haben, was passiert ist, wie man es reproduziert. Markdown funktioniert (Kapitel 06).
- Ziehen Sie Dateien in das Textfeld, um Screenshots und Logs anzuhängen.
Werkzeuge zum Ordnen
| Feld | Wofür es da ist |
|---|---|
| Labels | Klassifizieren das Issue: fehler, feature, doku, dringend |
| Meilenstein | Bindet Issues an eine Version oder ein Datum |
| Zuständig | Wem die Arbeit gehört |
| Abhängigkeiten | Dieses Issue kann erst nach jenem beginnen |
Legen Sie Labels einmalig unter Issues → Labels an; danach benutzen alle dasselbe Vokabular.
Ein Issue per Commit schließen
Schreiben Sie die Issue-Nummer in die Commit-Nachricht — sobald die Änderung in main landet, schließt sich das Issue von selbst:
Ausrichtung der Anmeldeseite auf dem Handy korrigieren
Fixes #12
Fixes, Closes und Resolves wirken gleich. Nur verweisen, ohne zu schließen: einfach #12 schreiben.
Suche und Filter
Die Filter über der Issue-Liste grenzen nach Label, Meilenstein, Zuständigem und Status ein. Die entstehende Abfrage in der Adresszeile ist teilbar — geben Sie dem Team den Link „offene Fehler“.
Projekte (Boards)
Projekte → Neues Projekt öffnet ein Kanban-Board: Issues wandern zwischen Zu erledigen / In Arbeit / Fertig. Wird ein Issue geschlossen, schließt sich auch seine Karte. Ein Board ersetzt Issues nicht, es ordnet sie.
Wiki
Der Reiter Wiki ist ein Dokumentenbereich am Repository, aber getrennt davon: Einrichtungsnotizen, Architekturentscheidungen, Besprechungsergebnisse. Die Seiten sind Markdown und führen eine eigene Historie.
Faustregel: wie der Code funktioniert gehört ins Repository (readme.md), das Wissen drumherum ins Wiki.
Aktivität
Der Reiter Aktivität zeigt für einen gewählten Zeitraum, wer was getan hat: Commits, geöffnete und geschlossene Issues, zusammengeführte Pull Requests. Eine fertige Zusammenfassung für den wöchentlichen Statustermin.