# 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).