# Kapitel 3 – Neue Issues erstellen

# Seite 3.1 – Wann lege ich ein Issue an?

Lege ein neues Issue an, wenn du z. B.:

- einen **Fehler** entdeckst,
- eine **Verbesserung** oder **neue Funktion** vorschlagen möchtest,
- eine **Frage** hast, die projektbezogen dokumentiert werden soll,
- eine **Aufgabe** im Team transparent verfolgen möchtest.

Kein Issue brauchst du für:

- rein persönliche Notizen (dafür ist Gitea nicht gedacht),
- Themen, die in einem anderen Projekt/Tool dokumentiert werden sollen (z. B. allgemeiner Service-Desk).

# Seite 3.2 – Neues Issue Schritt für Schritt

1. Gehe im passenden Repository auf den Reiter **„Issues“**.
2. Klicke auf den Button **„New issue“**.
3. Fülle die Felder aus:
    
    
    - **Titel**  
        Kurz und prägnant, z. B.  
        „Login-Seite: Fehlermeldung bei gültigen Zugangsdaten“
    - **Beschreibung** (Details)
        
        
        - Was ist passiert?
        - Was hast du erwartet?
        - Wie kann man den Fehler nachstellen (Schritte)?
        - Browser, Datum/Uhrzeit, Umgebung (Test/Prod) falls relevant.
4. Klicke auf **„Create“ / „Submit new issue“**.

Das Issue erscheint jetzt in der Liste, und andere können daran weiterarbeiten.

# Seite 3.3 – Gute Beschreibungen schreiben

Je besser ein Issue beschrieben ist, desto schneller kann es bearbeitet werden.

**Empfehlung:**

- **Kurzbeschreibung** am Anfang:
    
    
    - „Beim Speichern eines neuen Benutzers erscheint eine Fehlermeldung ‚500 Internal Server Error‘.“
- **Schritte zum Nachstellen:**
    
    
    1. Auf „Benutzerverwaltung“ klicken.
    2. „Neuer Benutzer“ auswählen.
    3. Formular ausfüllen und auf „Speichern“ klicken.
- **Erwartetes Verhalten:**
    
    
    - „Der Benutzer sollte ohne Fehlermeldung gespeichert werden.“
- **Tatsächliches Verhalten:**
    
    
    - „Es erscheint eine weiße Seite mit ‚500 Internal Server Error‘.“
- **Umgebung:**
    
    
    - Browser, Datum/Uhrzeit, ggf. Test/Prod, Benutzerrolle.

Nutze ggf. **Aufzählungslisten und Überschriften**, um den Text zu strukturieren – Gitea unterstützt Markdown-Formatierung (z. B. `*` für Listen, `#` für Überschriften).

# Seite 3.4 – Anhänge & Screenshots

Je nach Konfiguration deiner Gitea-Instanz kannst du im Issue:

- **Bilder per Drag & Drop** in die Beschreibung oder einen Kommentar ziehen,
- oder Dateien über eine **Upload-Funktion** anhängen.

Gängige Praxis:

1. Screenshot erstellen.
2. Im Textfeld des Issues den Screenshot per Drag & Drop einfügen.
3. Gitea lädt das Bild hoch und fügt automatisch den richtigen Markdown-Code ein.

Wenn bei dir kein Upload möglich ist, solltest du:

- den Screenshot in einem anderen System ablegen (z. B. internes Fileshare)
- und im Issue einen **Link** dorthin einfügen.