Die meisten gemergten Änderungen gehören nicht in eine Release Note
Release Notes, die aus einem Commit-Log geschrieben werden, lesen sich wie ein Commit-Log. Kundinnen und Kunden erfahren von einem Refactoring, einem Dependency-Bump und einer Tippfehlerkorrektur und hören in der dritten Zeile auf zu lesen. Die eine Änderung, die sie brauchten, ist dann unsichtbar.
Eine Release Note beantwortet eine andere Frage als ein Changelog: Was kann jemand jetzt tun, das letzte Woche nicht ging, und was verhält sich anders. Die meiste gemergte Arbeit beantwortet keines von beiden.
Der Filter kann nicht nur auf Labels laufen, weil ein Label sagt, welche Art Arbeit es war, nicht ob eine Nutzerin oder ein Nutzer das Ergebnis wahrnimmt. Ein Performance-Fix ist intern, bis er ändert, worauf jemand wartet.
Die Notiz zu schreiben, ist die leichte Hälfte. Zu entscheiden, was hinein gehört, ist die Hälfte, die sorgfältig zu automatisieren sich lohnt, und die Hälfte, die ein Mensch bestätigen sollte.
So läuft der ActionFlow auf der Canvas
Ein Start Scheduled-Knoten öffnet die Wochensammlung, und ein GitHub-Knoten liest gemergte Pull Requests des Zeitraums mit ihren Beschreibungen und Labels.
Ein Filter-Knoten entfernt, was Ihr Team bereits als intern markiert hat, das ist günstig und fängt den Großteil des Rauschens.
Ein Text Classifier-Knoten sortiert den Rest dann nach Nutzersichtbarkeit, nicht nach Arbeitsart. Ein If-Knoten leitet alles Mehrdeutige auf die Prüfliste, statt in die Notiz.
Ein Generate Object-Knoten gibt je eingeschlossener Änderung zurück, was eine Nutzerin oder ein Nutzer jetzt tun kann und was sich anders verhält, aus der Nutzerseite formuliert, nicht aus der des Codes.
Ein Generate Text-Knoten setzt die Notiz in Ihrer Hausstruktur zusammen, unter Überschriften, die Ihre Kundinnen und Kunden aus früheren Releases bereits erkennen.
Ein Notion-Knoten hält den Entwurf. Ein Google-Docs-Knoten hält die Fassung in Bearbeitung, damit die Produktmanagerin oder der Produktmanager dort arbeitet, wo sie oder er sonst arbeitet.
Ein Human in the Loop-Knoten gibt die Veröffentlichung frei. Der Flow schreibt die Notiz. Ein Mensch entscheidet, dass sie stimmt, und sendet sie.
Knoten, die dieser ActionFlow verwendet
- Start Scheduled (Start): öffnet das wöchentliche Sammelfenster.
- GitHub (Integration): gemergte Pull Requests mit Beschreibungen und Labels. Bitbucket passt in denselben Slot.
- Filter (Data): entfernt Einträge, die das Team bereits als intern markiert hat.
- Text Classifier (AI Custom): sortiert nach Nutzersichtbarkeit, nicht nach Arbeitsart.
- If (Control): leitet mehrdeutige Änderungen zur Prüfung, nicht in die Notiz.
- Generate Object (AI Core): was eine Nutzerin oder ein Nutzer jetzt tun kann, und was sich anders verhält.
- Google Docs (Integration): der Entwurf, den die Produktmanagerin oder der Produktmanager bearbeitet.
- Email (Human in the Loop): gibt die Veröffentlichung frei. Nichts geht ungelesen raus.
Häufige Fragen
Newsletter
Produktupdates erhalten
Neue Nodes, Agents und Produktnotizen. Wir senden E-Mails nur, wenn sich das Öffnen lohnt.