Van ticket tot gepubliceerde release note met AI
De uitdaging
Bij elke release van het OMS-platform komen tientallen verbeteringen en nieuwe functies beschikbaar. Die moeten begrijpelijk, volledig en zonder technisch jargon gecommuniceerd worden naar gebruikers.
Dat klinkt eenvoudig, maar in de praktijk bleek het een structureel knelpunt. Ontwikkelaars werken vanuit Asana-tickets. Dit zijn technische omschrijvingen van wat er gebouwd moet worden. Na oplevering moest iemand die technische beschrijving vertalen naar gebruiksvriendelijke release notes. Dat kostte tijd, het bleef liggen en het resultaat was wisselend van kwaliteit. Soms waren de notes te technisch, soms te summier. En regelmatig werden ze simpelweg vergeten. Het gevolg: gebruikers misten nieuwe functionaliteit of begrepen niet wat er veranderd was.
De oplossing
We bouwden een volledig geautomatiseerde pipeline die de kloof tussen ontwikkeling en communicatie overbrugt.
Het proces start bij de ontwikkelaar. Zodra een functie klaar is, wordt het Asana-ticket gemarkeerd als onderdeel van een specifieke versie. Dat is het enige wat de ontwikkelaar hoeft te doen. Vanaf dat moment neemt de AI tool die we gebouwd hebben het over. De koppeling tussen Asana en de codebase zorgt ervoor dat de bijbehorende code-wijzigingen worden opgehaald. Vervolgens analyseert AI, gevoed met zowel de originele ticketomschrijving als de daadwerkelijk gebouwde code wat er exact is opgeleverd.
De AI schrijft vervolgens twee dingen: een beknopte release note highlight voor in de versieoverzichtpagina, en een uitgebreide functiebeschrijving die uitlegt wat de gebruiker er concreet aan heeft. De gegenereerde tekst wordt automatisch klaargezet voor review. De developers en de projectmanager kunnen de tekst bekijken, eventueel finetunen en met één klik publiceren op de OMS releases website.
