Board, Releases und Dokumentation

Stand:

Komponenten

Ein Projekt lässt sich in Komponenten teilen: Teile, die getrennt ausgeliefert werden, aber Team, Issue-Schlüssel, Workflow und Berechtigungen des Projekts teilen, etwa API, Fahrer-App und Web-Portal. Was ein eigenes Team, eigene Berechtigungen, einen eigenen Kunden oder Workflow braucht, ist ein eigenes Projekt. Projekte ohne Komponenten funktionieren genau wie bisher.

  • Einrichten: Projekt-Admins legen Komponenten auf der Projektseite im Tab Komponenten an. Jede hat einen Namen, ein kurzes Kürzel auf ihrer farbigen Kachel (API, DA), eine Beschreibung, eine Leitung und eine Standard-Zuständige(n). Archivieren blendet eine Komponente in den Auswahlen aus; an ihren Issues und Releases bleibt sie.
  • Am Issue: Ein Issue gehört zu höchstens einer Komponente (Komponente in den Details; leer = Projektweit).
    • Ein neues Issue ohne Zuständige(n) bekommt die Standard-Zuständige(n) der Komponente.
    • Wechselt die Komponente, fällt ein Release einer anderen Komponente weg, und IT4S sagt es.
    • Wird das Issue in ein anderes Projekt verschoben, behält es eine Komponente mit demselben Kürzel dort.
    • Epics haben keine eigene Komponente: Ein Epic umspannt Komponenten über seine Issues.
    • Wer sie setzen darf: dieselben Personen, die das Release setzen dürfen (Verwaltung › Berechtigungen).
  • Issue-Liste und Board: ein Filter Komponente (über + Filter › Planung), eine Spalte Komponente in der Liste und im Board Gruppieren nach: Komponente. Die Massenbearbeitung kann die Komponente ebenfalls setzen.
  • Release-Linien: Ein Release kann zu einer Komponente gehören (Komponente auf der Release-Seite); dann nimmt es nur Issues dieser Komponente auf. Am Issue zeigt die Auswahl Release zuerst die Releases der Komponente, dann die projektweiten, und sagt, wie viele Releases anderer Komponenten ausgeblendet sind.
  • Epics über Komponenten: Ein Epic, dessen Issues Komponenten haben, zeigt Fortschritt je Komponente und listet seine Issues nach Komponente. Issues für Komponenten anlegen erzeugt in einem Schritt je gewählter Komponente ein untergeordnetes Issue mit dem Titel [API] Titel.

Board

  • Eine Spalte je Status über die Projekte Ihrer Auswahl. Die Werkzeugleiste funktioniert wie die der Issue-Liste: zuerst Ansichten ▾, dann die festen Chips Release, Status, Zuständig und Typ, die hinzugefügten Chips, + Filter (oder F) und Alle zurücksetzen. Im Board bietet + Filter Priorität, Epic, Tags, Komponente und Melder. Einen Filterbereich gibt es nicht. Chips, die nicht mehr passen, liegen hinter + n Filter, und ein aktiver Filter ist blau mit einem ×, das ihn zurücksetzt.
  • Ansicht ▾ (rechts) enthält Gruppieren nach, Alle ausklappen / Alle einklappen und den Schalter Sub-tasks anzeigen; danach kommt das Such-Symbol.
  • Status enthält im Board Backlog (die Spalte Backlog zeigen) und wie weit die Spalte Erledigt zurückreicht: Erledigt: Letzte 7 Tage (Standard), 14 oder 30 Tage oder alle.
  • Swimlanes: Ansicht ▾ › Gruppieren nach: Epic, Story, Zuständig, Typ, Release oder Komponente. Jede Bahn lässt sich zuklappen, und IT4S merkt sich das je Gruppierung; Alle ausklappen / Alle einklappen steht im selben Menü.
    • Story zeigt jede Story, jeden Task und Bug mit seinen Sub-Tasks in einer Bahn, in Board-Reihenfolge. Sub-Tasks erscheinen hier auch, wenn Sub-tasks anzeigen aus ist. Epics stehen unter Keine Story.
    • Typ hat eine Bahn je Typ: Epic, Story, Task, Bug, Sub-Task.
    • Release folgt der Reihenfolge der Release-Liste, Kein Release zuletzt. Bei mehreren Projekten zeigt die Bahn auch das Projekt (WEB · 1.0).
    • Komponente hat eine Bahn je Komponente, Projektweit zuletzt.
  • Ansichten: Ansichten ▾ speichert die Filter des Boards, die Status-Einstellungen und die Gruppierung unter einem Namen und holt sie mit einem Klick zurück. Das Board hat eigene Ansichten, getrennt von denen der Issue-Liste; siehe Issues.
  • Ziehen Sie eine Karte, um Status und Reihenfolge zu ändern, oder nutzen Sie Verschieben nach…; Rückgängig in der Meldung nimmt es zurück. Karten wandern innerhalb ihrer Bahn zwischen den Spalten. Jede Spalte zeigt die Anzahl und die Summe der Schätzungen.
  • Ein Stift-Punkt neben dem Typ heißt: Jemand anderes hat gerade ungespeicherte Änderungen an diesem Issue; fahren Sie mit der Maus darüber, um zu sehen, wer.

Releases

  • Ein Release (Fix-Version) gehört zu einem Projekt: Name, Status (Offen, Veröffentlicht, Archiviert), Start- und Release-Datum, Beschreibung und optional eine Komponente.
  • Projektfilter: Der Chip Projekt auf der Seite Releases zeigt nur die Releases einzelner Projekte, ohne die Projektauswahl in der oberen Leiste zu ändern. Er bietet die Projekte Ihrer Auswahl an, die Releases haben, und IT4S merkt sich Ihre Wahl. Grenzen Sie die Auswahl so ein, dass keines der gewählten Projekte mehr darin ist, springt der Chip auf Alle zurück.
  • Nach Komponente: Haben die Projekte Ihrer Auswahl Komponenten, zeigt die Seite Releases eine Zeile je Release-Linie, mit ihrer Leitung und einer Zeitleiste.
    • Die Zeitleiste zeigt die zuletzt veröffentlichte Version, dann die kommenden nach Datum; die nächste ist als aktuell markiert, mit ihrem Fortschritt.
    • Projekt-Admins können dort direkt Nächstes Release planen.
    • Ansicht: Liste wechselt zur Tabelle.

Die Release-Seite

Ein Release öffnet sich zum Lesen:

  • Die Überschrift ist der Name des Release (Release 2.4); die Zeile darunter nennt das Projekt und die letzte Änderung.
  • Übersicht (erster Tab, nur lesen): der Fortschritt als Balken nach Status mit den Anzahlen, blockierte Issues und worauf sie warten (ein offenes Issue des Projekts, das sie blockiert), die offenen Issues mit ihrer Zuständigkeit, die Termine und die Release Notes (Schreiben → / Bearbeiten → öffnet ihren Tab).
  • Veröffentlichen… (Projekt-Admins, solange das Release nicht veröffentlicht ist) fragt erst nach, setzt es dann auf Veröffentlicht, mit dem heutigen Datum, falls keines gesetzt ist. Sind noch Issues offen, fragt IT4S, wohin sie verschoben werden; brechen Sie das ab, bleibt das Release unveröffentlicht.
  • Danach die Tabs Allgemein (dort bearbeiten Sie das Release) · Release Notes (Markdown; Aus Issues erstellen entwirft Notes aus den erledigten Issues) · Issues (mit Erledigt 12 / 15) · Dokumentation. Die Leiste Abbrechen · Speichern und schließen · Speichern erscheint nur, solange etwas ungespeichert ist.
  • Ein neues Release zeigt Allgemein und Issues; Release Notes und Dokumentation kommen nach dem ersten Speichern.
  • Ein Release eines inaktiven Projekts zeigt einen Hinweis und ist schreibgeschützt.
  • Mit KI erstellen (wenn ein Admin KI eingeschaltet hat): Claude schreibt Release Notes für Ihre Kunden.
    • Inhalt: eine kurze Zusammenfassung, Neue Funktionen, Verbesserungen, Fehlerbehebungen und, falls noch Issues offen sind, Bekannte Probleme / nicht enthalten, mit den Issue-Schlüsseln als Links.
    • Was sie verwendet: nur, was Kunden sehen dürfen (Titel, Beschreibungen, Typen, Status, Epics, Tags), nie interne Notizen, technische Pläne, Prompts oder Kommentare.
    • Sprache: neben dem Knopf wählbar (English oder Deutsch); sie beginnt mit Ihrer Oberflächensprache.
    • Während sie schreibt: Der Text erscheint im Editor; Abbrechen stoppt und bringt Ihren Text zurück.
    • Vorhandene Notes: Steht schon etwas im Editor, wählen Sie Ersetzen oder Am Ende anfügen.
    • Speichern: Gespeichert wird erst mit Speichern, und Rückgängig in der Meldung stellt den vorherigen Text wieder her.
  • Veröffentlichen über die Status-Pill geht auch, und mit offenen Issues fragt es, wohin sie verschoben werden.

Ein Release planen: der Tab Issues

Projekt-Admins wählen die Issues eines Releases im Tab Issues aus, beim Anlegen und bei jedem offenen Release. Veröffentlichte und archivierte Releases sowie andere Benutzer sehen die Liste seiner Issues.

  • Verfügbar (links) listet die offenen Stories, Tasks und Bugs, die hineinpassen, nach Epic gruppiert (Ohne Epic zuletzt). Sub-Tasks stehen nicht in der Liste: Sie folgen immer ihrem übergeordneten Issue.
    • Quelle: Offen, ohne Release (Standard), Nur Backlog oder In anderen offenen Releases (die Zeile zeigt in 1.25; Verschieben nimmt es aus jenem Release).
    • Filter: Typ, Epic, Priorität, Zuständig, Tags und ein Suchfeld; Ansichten speichert sie wie in der Issue-Liste.
    • Ein Release einer Komponente bietet nur Issues dieser Komponente an.
  • In 1.24 (rechts) listet die Issues des Releases nach Rang. Beide Seiten zeigen Alle auswählen und die Summe der Schätzungen.
  • Verschieben: Issues ankreuzen und → oder ← drücken, hinüberziehen (eine angekreuzte Zeile nimmt die anderen angekreuzten mit) oder eine Zeile doppelt anklicken. Verschobene Zeilen sind mit Neu oder Herausgenommen markiert.
  • Speichern: Es ändert sich nichts, bis Sie auf Speichern klicken. Der Tab bekommt einen Punkt, und die Fußzeile sagt, was passieren wird, etwa 4 Issues kommen in 1.24 · 1 Issue wird aus 1.24 genommen. Abbrechen verwirft die Verschiebungen. Beim Speichern wandert jedes Issue mit seinen offenen Sub-Tasks, und die Historie des Issues zeigt das neue Release.
  • Kann ein Issue nicht hinein (es gehört zu einer anderen Komponente oder zu einem bereits veröffentlichten Release), wird nichts gespeichert, und die Meldung nennt das Issue.

Issues mit KI vorschlagen (wenn ein Admin KI eingeschaltet hat; bei einem gespeicherten Release):

  1. Wählen Sie den Schwerpunkt: Ausgewogen, Features (Stories, die Benutzer bemerken) oder Technik & Bugs.
  2. Prüfen Sie die Kapazität: IT4S trägt die Arbeitstage bis zum Release-Datum ein (etwa 7d); Sie können auch Stunden (40h) oder Story Points (20 pts) eingeben.
  3. Klicken Sie auf Issues vorschlagen. Claude liest die offenen Issues (Titel, Anfang der Beschreibung, Typ, Priorität, Status, Schätzung, Epic, Tags, Alter und was sie blockiert) und was schon im Release ist, und schlägt die passenden vor, die besten zuerst, jeweils mit einer kurzen Begründung in Ihrer Sprache.
  4. Hinzufügen übernimmt einen Vorschlag, Verwerfen lehnt ihn ab, Alle hinzufügen nimmt alle. Vorschläge sind in der Liste Verfügbar auch mit KI markiert.

Die KI schlägt nur vor: Ins Release kommt nichts, bis Sie Vorschläge hinzufügen und auf Speichern klicken.

Dokumentation

  • Arbeit › Dokumentation: Seiten je Projekt, verschachtelt als Unterseiten, mit Kennungen wie WEB-DOC-3. Filter nach Release; das Projekt kommt aus der Projektauswahl.
  • Seiten ordnen Sie per Ziehen oder über das Zeilenmenü (Nach oben/unten, Einrücken, Ausrücken).
  • Seiten sind Markdown mit Bildern und Dateien. Issue-Schlüssel (WEB-42) erscheinen als Chips mit Titel und Status; der Tab Sub-tasks & Links des Issues listet die Seiten, die es erwähnen. Issue verlinken in der Werkzeugleiste fügt einen Schlüssel ein.
  • Beim Bearbeiten einer Seite hat der Hauptbereich nur Titel und Editor. Release und Sichtbarkeit stehen in den Details rechts (zuklappbar, wie bei Issues), zusammen mit Kennung, Version und wer die Seite angelegt und geändert hat.
  • Jede Seite hat Kommentare und eine Historie; Löschen verschiebt die Seite mit ihren Unterseiten in den Papierkorb, mit Rückgängig.
  • Projekte zeigen ihre Seiten im Tab Dokumentation, Releases in ihrem.
  • Seiten eines inaktiven Projekts zeigen einen Hinweis und lassen sich nicht bearbeiten.
  • Wer noch da ist: Wie bei Issues zeigen eine Seite und ihre Bearbeitungsseite die Bilder der anderen, die sie offen haben; ein Stift bedeutet ungespeicherte Änderungen in deren Editor, und ein Hinweis warnt Sie, wenn Sie beide bearbeiten.

Interne und öffentliche Seiten

  • Jede Seite ist Intern (nur das Team) oder Öffentlich (auch die Kunden des Projekts können sie lesen). Wählen Sie das unter Sichtbarkeit in den Details, wenn Sie die Seite bearbeiten.
  • Neue Seiten beginnen mit der Standard-Sichtbarkeit der Dokumentation des Projekts (Projekteinstellungen); hat kein Admin sie geändert, ist das Intern.
  • Eine öffentliche Seite sehen Kunden nur, wenn jede Seite darüber ebenfalls öffentlich ist. Der Baum markiert öffentliche Seiten mit Öffentlich; Öffentlich · verborgen heißt, eine Seite darüber ist intern, Kunden sehen sie also noch nicht.
  • Kunden sehen die öffentlichen Seiten im Baum, in der Suche und an ihren Issues, aber nicht die Kommentare oder die Historie einer Seite, und sie können nicht bearbeiten.