# Gitea Issue-Management Anleitungen und Hilfen zum Gitea Ticketsystem. # Kapitel 1 – Überblick & Einstieg # Seite 1.1 – Was ist Gitea für dich? Gitea ist eine Web-Plattform, auf der Teams ihre Software-Projekte verwalten – ähnlich wie GitHub oder GitLab. Neben dem Quellcode gibt es dort ein integriertes **Issue-Tracking**, also ein System für Aufgaben, Fehler und Wünsche. In diesem Handbuch geht es **nur** um den Teil: > **Issues** → Tickets für Aufgaben, Fehler und Ideen. Du kannst Gitea-Issues nutzen, um zum Beispiel: - Fehler („Bugs“) zu melden, - neue Features oder Verbesserungen vorzuschlagen, - Aufgaben zu koordinieren, - den Status deiner Meldungen nachzuverfolgen (offen, in Arbeit, erledigt). Alles, was mit Git, Branches oder Pull Requests zu tun hat, lassen wir hier bewusst weg. # Seite 1.2 – Anmeldung über LDAP Die Anmeldung an Gitea erfolgt bei euch **über LDAP**. Das bedeutet: - Du verwendest **dieselben Zugangsdaten** wie z. B. für: - dein Windows-/Firmen-Login oder - dein zentrales Organisations-Konto (Active Directory o. Ä.). **So meldest du dich an:** 1. Öffne (wie gewohnt über die Hauptnavigation, siehe 1.3) Gitea im Browser. 2. Es erscheint die Login-Seite von Gitea. 3. Gib deinen **Benutzernamen** und dein **Kennwort** aus dem Verzeichnisdienst ein. 4. Klicke auf **„Anmelden / Sign In“**. Wenn Benutzername oder Passwort nicht stimmen oder dein Konto im Verzeichnis gesperrt ist, kannst du dich auch in Gitea nicht anmelden. Die Passwortänderung erfolgt dann nicht in Gitea, sondern im üblichen Firmen-/Organisationsprozess (z. B. Self-Service-Portal oder IT-Helpdesk). # Seite 1.3 – Zum richtigen Repository (Hauptnavigation & Issues-Tab) In eurer Umgebung ist das passende Gitea-Repository bereits in der **Hauptnavigation verlinkt**. Typische Beispiele: - „Tickets Projekt X“ - „Gitea – Projekt Y“ - „Issue-Tracker“ **So kommst du mit möglichst wenig Klicks zu „deinen“ Issues:** 1. **Hauptnavigation im Intranet / Portal:** - Klicke auf den Eintrag, der dich zum Projekt-Repository führt. (Beispiel: *„Projekt X – Tickets (Gitea)“*.) 2. Du landest direkt auf der **Startseite des Repositorys** in Gitea. 3. In der Navigationsleiste des Repositorys findest du Reiter wie: - **Code**, **Issues**, evtl. **Pull Requests**, **Wiki** usw. 4. Klicke auf den Reiter **„Issues“** – dort befindet sich das Issue-Management. [about.gitea.com+1](https://about.gitea.com/?utm_source=chatgpt.com) Ab jetzt arbeitest du nur noch in diesem Bereich. # Kapitel 2 – Issues ansehen & verstehen # Seite 2.1 – Die Issue-Liste Im Reiter **„Issues“** siehst du eine Liste aller Tickets des Projekts. Gitea unterstützt u. a. Status, Labels, Meilensteine, Zuordnung und Zeitangaben für Issues. Typische Elemente der Liste: - **Suchfeld** oben (Textsuche in Titel/Beschreibung). - **Filter-Leiste**: - Status: *Open* / *Closed* - ggf. weitere Filter (Labels, Bearbeiter:in) je nach Version. - **Einträge** in der Liste mit: - **Issue-Nummer** (z. B. `#42`) - **Titel** (kurze Zusammenfassung) - **Status** (offen/geschlossen) - **Labels** (farbige Markierungen) - **Zuständig** (verantwortliche Person) - ggf. **Meilenstein** / **Fälligkeitsdatum**. Ein Klick auf den **Titel** eines Issues öffnet die Detailansicht. # Seite 2.2 – Einzelnes Issue im Detail Wenn du ein Issue anklickst, siehst du: 1. **Kopfbereich** - Titel, Nummer (z. B. `#42`) - Status (*Open* oder *Closed*) - Ersteller:in und Erstellungsdatum. 2. **Beschreibung** - Der ursprünglich eingegebene Text, - oft mit Formatierung (Überschriften, Listen, Screenshots). 3. **Zuordnungen** - **Zuständig**: wer sich darum kümmert. - **Labels**: Kategorie, Typ, Priorität usw. (z. B. `bug`, `feature`, `prio-high`). - ggf. **Meilenstein** (größerer Arbeitsabschnitt). 4. **Diskussion / Kommentare** - Verlauf aller Antworten, Rückfragen, Statusänderungen. 5. **Seitliche Leiste (rechte Spalte)** - Meist findest du hier: Labels, Verantwortliche, Zeittracking, Verknüpfungen. So kannst du auf einen Blick sehen: - Worum es geht, - wer zuständig ist, - in welchem Status das Ticket ist, - was zuletzt passiert ist. # Seite 2.3 – Suchen & Filtern Die Issue-Liste lässt sich filtern, um schnell das zu finden, was du suchst. Typische Möglichkeiten (abhängig von Version und Konfiguration): 1. **Status** - *Open*: alle offenen Issues - *Closed*: erledigte/geschlossene Issues 2. **Suche** - Freitext im Titel/Beschreibung, - nutze Schlüsselwörter (z. B. „Login“, „Fehler“, Ticketnummer). 3. **Labels** (falls freigeschaltet) - Nach einem Label filtern (z. B. nur `bug` oder nur `feature` anzeigen). 4. **Zuständig** - Nur Issues anzeigen, die dir zugewiesen sind. > **Tipp:** > Wenn du regelmäßig mit Issues arbeitest, ist der Filter „Assigned to me“ oder eine Kombination mit Labels („Meine Bugs“, „Meine Features“) sehr praktisch. # 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. # 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.:
`- [ ] Fehler nachvollzogen`
`- [ ] Ursache gefunden`
`- [ ] Fix implementiert`
`- [ ] Getestet in Testumgebung`
`- [ ] In Produktion ausgerollt`
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. # Kapitel 5 – Benachrichtigungen & Zusammenarbeit # Seite 5.1 – Issues beobachten (Watch/Unwatch) Wenn du über Änderungen an einem bestimmten Issue informiert werden möchtest, kannst du es **beobachten**: - Entweder automatisch (z. B. als Ersteller:in oder Assignee), - oder manuell über einen Button wie **„Subscribe“ / „Watch“**. Typischer Ablauf: 1. Öffne das Issue. 2. Klicke auf den entsprechenden Button (z. B. „Watch“). 3. Du erhältst dann E-Mails bzw. Web-Benachrichtigungen bei neuen Kommentaren oder Statusänderungen. Um Benachrichtigungen abzuschalten, klickst du einfach auf **„Unwatch“** oder die entsprechende Option. # Seite 5.2 – E-Mail-Benachrichtigungen Je nach Konfiguration bekommst du E-Mails, wenn: - jemand ein Issue erstellt, das dich betrifft (z. B. du wirst als Assignee eingetragen), - jemand dich in einem Kommentar erwähnt (`@dein.name`), - ein von dir beobachtetes Issue kommentiert oder geschlossen wird. **Typische E-Mail-Inhalte:** - Titel und Nummer des Issues, - Auszug aus dem Kommentartext, - Link direkt zum Issue in Gitea. Du kannst dann: - direkt aus der Mail heraus den Link öffnen, - im Browser kommentieren oder den Status ändern. # Seite 5.3 – Andere Personen einbeziehen (@-Mentions) Um Kolleg:innen auf ein Issue aufmerksam zu machen, kannst du in Kommentaren oder in der Beschreibung **@-Mentions** verwenden: - `@max.mustermann` – informiert Max über dieses Issue, - `@team-xyz` – informiert ggf. ein Team (wenn Teams in Gitea so eingerichtet sind). Das ist besonders hilfreich, wenn: - du eine fachliche Rückfrage hast, - du jemanden explizit um Freigabe oder Entscheidung bitten möchtest. # Kapitel 6 – Best Practices & FAQ # Seite 6.1 – Was gehört in ein gutes Issue? **Kurzfassung:** 1. Klarer **Titel**. 2. Verständliche **Beschreibung**: - Was ist das Problem / die Aufgabe? - Was ist das Ziel? 3. **Kontext**: - Umgebung, Nutzerrolle, Datum/Uhrzeit. 4. **Reproduzierbarkeit**: - Konkrete Schritte, wie man es nachstellen kann. 5. **Anhänge**: - Screenshots, Logauszüge oder Links zu relevanten Dokumenten. Je sauberer das Issue, desto weniger Nachfragen – und desto schneller kommt man zur Lösung. # Seite 6.2 – Häufige Fragen von Anwender:innen **Frage:** Ich kann mich nicht in Gitea anmelden. **Antwort:** Prüfe zuerst, ob deine LDAP-Zugangsdaten (Benutzername/Passwort) generell funktionieren (z. B. Windows-Login). Wenn ja und nur Gitea Probleme macht, melde dich beim IT-Support – eventuell ist dein Gitea-Zugang noch nicht freigeschaltet oder es gibt eine Störung. --- **Frage:** Ich sehe den Reiter „Issues“ nicht. **Antwort:** Entweder bist du nicht im richtigen Repository, oder Issues sind für dieses Repository deaktiviert. Nutze den Link in der Hauptnavigation und/oder frage bei der Projektleitung nach, ob Issues für dieses Projekt freigeschaltet sind. --- **Frage:** Ich kann keine Labels setzen oder Assignees ändern. **Antwort:** Für das Vergeben von Labels, Zuordnen von Verantwortlichen oder Ändern bestimmter Felder brauchst du entsprechende Rechte im Repository. Wenn dir diese Funktionen fehlen, bitte eine:n Projektverantwortliche:n oder Admin, das für dich zu übernehmen oder dir die nötigen Rechte zu geben. --- **Frage:** Ich finde „mein“ Issue nicht wieder. **Antwort:** 1. Im Issues-Reiter Status auf **„Open“** und dann auf **„Closed“** stellen – vielleicht wurde es bereits geschlossen. 2. Im Suchfeld nach einem Stichwort aus dem Titel oder deinem Namen suchen.