Genera note di rilascio rivolte ai clienti

Zero legge i commit e le PR mergiate, raggruppa le modifiche per impatto sul cliente e redige note di rilascio chiare e specifiche pronte per la pubblicazione.

Zero connette:

Cosa offre Zero

Genera note di rilascio rivolte ai clienti — sample output from Zero — screenshot 1

Qual è il problema

Le note di rilascio sono sempre l'ultima cosa a essere scritta e la prima a essere tagliata quando il rilascio è in ritardo. Il problema è la materia prima: messaggi di commit scritti per gli ingegneri, titoli di PR che presuppongono conoscenze interne e 30 PR mergiate che ai tuoi utenti per lo più non interessano singolarmente. Il generatore di note di rilascio ribalta il workflow. Zero legge i commit e le descrizioni delle PR, filtra le modifiche visibili al cliente, le raggruppa per tema (nuove feature, miglioramenti, correzioni) e scrive le note con la voce che i tuoi clienti leggono davvero. Tu rivedi, e il rilascio successivo esce con le note invece che con il silenzio.

Come Zero lo risolve

Passo 1: Connetti i tuoi strumenti

GitHub

Obbligatorio

GitHub. Zero legge le PR mergiate, i messaggi di commit, le etichette e i tag di release. È richiesto l'accesso in lettura al repository.

Connetti

Slack

Obbligatorio

Slack. Zero recapita le bozze al canale di revisione e pubblica le note finali una volta approvate. È richiesto l'accesso in scrittura al canale.

Connetti

Passo 2: Chiedi a Zero

@Zero per il rilascio che facciamo oggi, leggi tutte le PR mergiate dall'ultimo tag di release. Raggruppa per impatto sul cliente: nuove feature, miglioramenti, correzioni di bug. Salta i refactoring interni e le modifiche ai test. Redigi note rivolte ai clienti con la voce del nostro prodotto.

provalo

Zero legge ogni PR mergiata nella finestra di rilascio

Zero recupera le PR mergiate dall'ultimo tag di release, inclusi titoli, descrizioni ed etichette. Le modifiche solo interne (refactoring, test, ritocchi alla CI) vengono filtrate in base alla tua convenzione di etichette.

Zero raggruppa le modifiche per impatto sul cliente

Zero raggruppa le PR rimanenti in temi: nuove feature, miglioramenti e correzioni. Ogni modifica viene riscritta dalla descrizione della PR in una riga rivolta al cliente: abbastanza specifica da essere utile, libera dal gergo interno.

Zero redige le note con la voce del tuo prodotto

La bozza finale arriva nel tuo strumento di documentazione o su Slack con sezioni che seguono il tuo template di note di rilascio. Tu modifichi la voce e le sfumature, poi pubblichi.

Passo 3: Vai oltre

Affina la voce

Aggiorna le linee guida che Zero usa per tono e formattazione.

@Zero da ora in poi, salta le intestazioni Markdown nelle note di rilascio. Solo prosa semplice.

provalo

Concatena con la pubblicazione

Inserisci le note approvate direttamente nella tua documentazione o nel blog.

@Zero una volta che approvo le note, pubblicale nella sezione Releases della nostra documentazione e pubblica il link in #announcements.

provalo

Traduci

Genera le note in ogni lingua che supporti.

@Zero traduci le note di rilascio approvate in tedesco, giapponese e spagnolo. Mantieni la struttura delle sezioni.

provalo

Suggerimenti per risultati migliori

●Tagga le PR solo interne con un'etichetta coerente (come `internal` o `no-release-notes`). Zero può saltare solo ciò che contrassegni.

●Tieni una breve guida di stile per le note di rilascio nella tua documentazione. Voce rivolta al cliente, verbi attivi, niente gergo interno. Zero la recepisce e la applica a ogni rilascio.

●Redigi le note prima che il rilascio esca, non dopo. Rivedere una bozza mentre il lavoro è fresco è più veloce che ricostruire il contesto una settimana dopo.