This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
Board & Issues
Arbeit wird nur in Verbindung mit einem Issue aufgenommen. Ein Issue zu formulieren kann schwer fall. Dieser kleine Guide soll dabei helfen, Arbeit in logische und übersichtliche Issues zu zerlegen.
Ein gutes Issue beantwortet vier Fragen:
- Warum ändern wir etwas?
- Was soll nachher anders sein?
- Was gehört dazu – und was nicht?
- Wann ist es fertig?
Konkret formuliert sollten alle Issues diesem Template folgen:
Motivation / Kontext
Warum gibt es dieses Issue? Welches Problem, welche Irritation oder welche technische Schuld wird adressiert?
Ziel
Was soll nach dem Merge wahr sein, was vorher nicht der Fall war?
Scope
In diesem Issue:
- …
Nicht Teil dieses Issues:
- …
Akzeptanzkriterien
- …
- …
Tests / Qualität (optional, nur wenn zutreffend)
- Welche Tests sind betroffen oder neu nötig?
Durch Einhalten dieser Struktur, sollen Arbeitsaufträge einen übersichtlichen und messbaren Umfang erhalten. Am wichtigsten dabei ist, dass "Feature Creep" verhindert werden soll, indem keine Dinge getan werden, welche das Issue nicht explizit beschreibt.
Issue-Typen
Werden dem Issue-Thema als Präfix voran gestellt. Dies erleichtert die Lesbarkeit auf dem Board und in der Issue-Liste. Sind identisch mit dem Label-Typen identisch.
Beispiele:
[FEATURE]: Neuer spannender Inhalt
[BUG]: Player Character fällt bei Start durch den Level