Gitea Issue-Management

Anleitungen und Hilfen zum Gitea Ticketsystem.

Kapitel 1 – Überblick & Einstieg

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:

Alles, was mit Git, Branches oder Pull Requests zu tun hat, lassen wir hier bewusst weg.

Kapitel 1 – Überblick & Einstieg

Seite 1.2 – Anmeldung über LDAP

Die Anmeldung an Gitea erfolgt bei euch über LDAP. Das bedeutet:

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

Kapitel 1 – Überblick & Einstieg

Seite 1.3 – Zum richtigen Repository (Hauptnavigation & Issues-Tab)

In eurer Umgebung ist das passende Gitea-Repository bereits in der Hauptnavigation verlinkt. Typische Beispiele:

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

Ab jetzt arbeitest du nur noch in diesem Bereich.

Kapitel 2 – Issues ansehen & verstehen

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:

Ein Klick auf den Titel eines Issues öffnet die Detailansicht.

Kapitel 2 – Issues ansehen & verstehen

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:

Kapitel 2 – Issues ansehen & verstehen

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

Kapitel 3 – Neue Issues erstellen

Seite 3.1 – Wann lege ich ein Issue an?

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

Kein Issue brauchst du für:

Kapitel 3 – Neue Issues erstellen

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.

Kapitel 3 – Neue Issues erstellen

Seite 3.3 – Gute Beschreibungen schreiben

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

Empfehlung:

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

Kapitel 3 – Neue Issues erstellen

Seite 3.4 – Anhänge & Screenshots

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

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:

Kapitel 4 – Mit Issues arbeiten

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:

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

Kapitel 4 – Mit Issues arbeiten

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

Ein Issue hat im Wesentlichen zwei Zustände:

Typische Abläufe:

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

Kapitel 4 – Mit Issues arbeiten

Seite 4.3 – Verantwortliche, Labels & Meilensteine

Zuständig (Verantwortliche Person)

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.:

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

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

Kapitel 4 – Mit Issues arbeiten

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

Kapitel 4 – Mit Issues arbeiten

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):

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

Kapitel 5 – Benachrichtigungen & Zusammenarbeit

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:

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.

Kapitel 5 – Benachrichtigungen & Zusammenarbeit

Seite 5.2 – E-Mail-Benachrichtigungen

Je nach Konfiguration bekommst du E-Mails, wenn:

Typische E-Mail-Inhalte:

Du kannst dann:

Kapitel 5 – Benachrichtigungen & Zusammenarbeit

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:

Das ist besonders hilfreich, wenn:

Kapitel 6 – Best Practices & FAQ

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.

Kapitel 6 – Best Practices & FAQ

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.