# Kapitel 4 – Mit Issues arbeiten

# Seite 4.1 – Kommentieren & Rückfragen klären

Im unteren Bereich eines Issues findest du das Feld für **Kommentare**.

Damit kannst du:

- Rückfragen stellen,
- zusätzliche Informationen liefern,
- den aktuellen Bearbeitungsstand festhalten,
- Entscheidungen dokumentieren.

**So kommentierst du:**

1. Scrolle zum Kommentarfeld.
2. Schreibe deinen Text.
3. Nutze bei Bedarf:
    
    
    - `@username` um eine Person direkt anzusprechen (diese wird benachrichtigt),
    - `#123` um auf ein anderes Issue `#123` zu verweisen (Gitea verlinkt automatisch).
4. Klicke auf **„Comment“** / **„Comment and Close“** (wenn du beim Kommentieren gleich schließen willst).

# Seite 4.2 – Status: offen, geschlossen, wieder öffnen

Ein Issue hat im Wesentlichen zwei Zustände:

- **Open** – offen / noch zu bearbeiten,
- **Closed** – geschlossen / erledigt / nicht mehr relevant.

Typische Abläufe:

- **Issue schließen**
    
    
    - Wenn das Problem gelöst ist oder die Aufgabe erledigt ist:
        
        
        1. Schreibe einen kurzen Kommentar („Problem ist mit Release X behoben.“).
        2. Klicke auf **„Close“** oder nutze **„Comment and Close“**.
- **Issue wieder öffnen**
    
    
    - Wenn das Problem erneut auftritt oder doch nicht erledigt ist:
        
        
        1. Klicke auf **„Reopen issue“**.
        2. Begründe kurz im Kommentar, warum du wieder öffnest.

Nicht alle Nutzer:innen dürfen den Status ändern; das hängt von den Berechtigungen ab.

# Seite 4.3 – Verantwortliche, Labels & Meilensteine

### Zuständig (Verantwortliche Person)

- Zeigt an, **wer** sich aktuell um das Issue kümmert.
- Kann z. B. vom Projektleiter oder Team definiert werden.

**So weist du jemanden zu (wenn du darfst):**

1. In der rechten Spalte auf **„Zuständig“** klicken.
2. Eine Person aus der Liste wählen.

### Labels

Labels dienen zur **Klassifizierung** von Issues, z. B.:

- Typ: `bug`, `feature`, `question`
- Priorität: `prio-high`, `prio-medium`, `prio-low`
- Bereich: `frontend`, `backend`, `api`, …

Gitea erlaubt es, Issues mit mehreren Labels zu versehen, um die Übersicht zu verbessern.

**So fügst du Labels hinzu (wenn du darfst):**

1. Rechts auf **„Labels“** klicken.
2. Ein oder mehrere Labels auswählen.
3. Speichern / Fenster schließen.

### Meilensteine

- Fassen Issues zu einem größeren Ziel oder Release zusammen (z. B. „Version 2.0“, „Sprint 5“).
- Helfen dem Team, den Fortschritt zu planen.

Ob du Meilensteine setzen kannst, hängt wiederum von deinen Rechten ab.

# Seite 4.4 – Checklisten & Teilaufgaben

Du kannst in der Issue-Beschreibung oder in Kommentaren **Checklisten** anlegen, z. B.:

<div class="contain-inline-size rounded-2xl relative bg-token-sidebar-surface-primary" id="bkmrk---%5B-%5D-fehler-nachvol"><div class="sticky top-9"><div class="absolute end-0 bottom-0 flex h-9 items-center pe-2"></div></div><div class="overflow-y-auto p-4" dir="ltr">`<span class="hljs-bullet">-</span> [ ] Fehler nachvollzogen`</div><div class="overflow-y-auto p-4" dir="ltr">`<span class="hljs-bullet">-</span> [ ] Ursache gefunden`</div><div class="overflow-y-auto p-4" dir="ltr">`<span class="hljs-bullet">-</span> [ ] Fix implementiert`</div><div class="overflow-y-auto p-4" dir="ltr">`<span class="hljs-bullet">-</span> [ ] Getestet in Testumgebung`</div><div class="overflow-y-auto p-4" dir="ltr">`<span class="hljs-bullet">-</span> [ ] In Produktion ausgerollt`</div></div>Die Kästchen lassen sich im Issue anklicken und abhaken. Dadurch eignet sich ein einzelnes Issue auch für **kleinere Teilaufgaben**.

Seit neueren Versionen können Issues außerdem untereinander referenziert werden (z. B. als Unter-Issues in einer Übersicht).

# Seite 4.5 – (Optional) Zeit erfassen

Deine Instanz kann **Zeittracking** für Issues aktiviert haben – also die Möglichkeit, Arbeitszeit auf Issues zu buchen oder Schätzungen zu hinterlegen. Gitea unterstützt u. a. Zeitverfolgung und Zeitschätzungen in Issues, um Planung und Nachverfolgung zu erleichtern.

Mögliche Funktionen (abhängig von Version/Konfiguration):

- **Zeit schätzen** (Estimate)
- **Geleistete Zeit erfassen** (Time spent)
- Auswertung im Projektmanagement.

Wenn du keine entsprechenden Felder siehst, ist die Funktion auf eurer Instanz entweder deaktiviert oder nur bestimmten Rollen vorbehalten.