📖 EZ-Games Issue Guide

Willkommen im Issue Guide! Hier dokumentieren und verwalten wir alle Aufgaben, Bugs und Features für unsere Projekte (wie Happy Forest). Diese Seite erklärt, wie wir Issues in Forgejo strukturieren, richtig anlegen und labeln.

🏷️ 1. Labels & Kategorien

Wir nutzen ein strukturiertes Label-System. Die meisten unserer Label-Kategorien (Scopes) sind exklusiv (mit dem Haken Exclusive) eingestellt. Das bedeutet, dass sich Labels derselben Kategorie gegenseitig ausschließen (ein Issue kann z. B. nicht gleichzeitig Typ/Bug und Typ/Feature oder Asset/2D und Asset/3D sein).

🎨 Assets (Exklusiv)

Asset/2D | Asset/3D | Asset/Animation | Asset/Sound | Asset/UI

💻 Code & Technik (Exklusiv)

Code/Gameplay | Code/Network | Code/Shader | Code/UI

🎲 Gamedesign (Exklusiv)

Design/Balance | Design/Game | Design/Level

📌 Typ (Ticket-Typ) (Exklusiv)

Typ/Bug: Fehler im Spiel oder System
Typ/Feature: Ein neues, größeres Feature
Typ/Enhancement: Verbesserung eines bestehenden Features
Typ/Documentation: Aufgaben rund um Wiki und Dokumentation

🚦 Priorität & Status (Exklusiv)

Priority: Priority/Critical | Priority/High | Priority/Medium | Priority/Low
Status: Status/Blocked (Wartet auf andere Aufgaben) | Status/Need More Info (Details fehlen)

✅ Approvals (Freigaben)

Approval/RZ-Approved, Approval/DZ-Approved, Approval/SM-Approved (Werden vergeben, wenn Teammitglieder ein Konzept oder Asset absegnen. Diese sind nicht exklusiv, damit mehrere Personen parallel freigeben können).

📝 2. Issues richtig anlegen

Ein gutes Issue ist klar formuliert und nutzt alle Funktionen von Forgejo, um alle wichtigen Infos für den Bearbeiter bereitzustellen:

Zuweisung (Assignees): Weise das Issue rechts in der Seitenleiste der Person zu, die die Aufgabe bearbeiten soll.
Markierungen: Mit @Username (z. B. @Pixel) kannst du Teammitglieder direkt erwähnen. Sie erhalten dann eine Benachrichtigung.
Tickets referenzieren: Schreibe einfach # gefolgt von der Ticketnummer (z. B. #12) in den Text oder einen Kommentar. Forgejo macht daraus automatisch einen klickbaren Link zum entsprechenden Issue.
Bilder & Code: Nutze Drag & Drop für Screenshots oder kleine Gameplay-Clips. Code-Schnipsel packst du in drei Backticks (```).

📋 To-Do-Listen (WICHTIG!)

Wenn eine Aufgabe aus mehreren Teilschritten besteht, nutze eine Markdown-Checkliste:

- [ ] Grundrisse planen
- [ ] 3D-Blockout erstellen
- [x] Texturen zuweisen (bereits erledigt)

Achtung: Damit Forgejo oben im Ticket einen Fortschrittsbalken (z. B. 1 von 3 erledigt) anzeigt, muss diese Liste im allerersten Beitrag (der Hauptbeschreibung) des Issues stehen, nicht in den Kommentaren!