Scrivere criteri di accettazione chiari con la dettatura vocale

«Permettere di salvare una bozza» sembra semplice, finché qualcuno non chiede cosa succede se il titolo è vuoto o se il salvataggio pubblica anche l’articolo. Magari sai spiegare il comportamento a voce, ma la descrizione dell’attività è ancora da scrivere.

La dettatura vocale permette di partire da quella spiegazione. Descrivi uno scenario, poi rielabora il testo in criteri di accettazione: i risultati osservabili necessari per accettare il lavoro. Per il concetto di base, puoi leggere l’introduzione di Atlassian ai criteri di accettazione, in inglese. Ecco un metodo pratico per passare dalla spiegazione parlata a un testo da rivedere insieme.

1. Apri l’attività prima di iniziare a parlare

Sul Mac, affianca la descrizione dell’attività al progetto grafico o agli appunti già concordati. Scegli un comportamento circoscritto, non l’intera funzionalità. Se stai descrivendo il salvataggio manuale di una bozza, lascia programmazione, pubblicazione e salvataggio automatico a discussioni separate, a meno che non rientrino già nell’ambito concordato.

Scrivi prima l’obiettivo in una frase: «Chi scrive può salvare un lavoro incompleto e riprenderlo in seguito». Ti aiuterà a mantenere la spiegazione centrata sulla persona che usa la funzione.

2. Detta il percorso seguendo cinque domande

Immagina di mostrare il funzionamento a un collega. Fai una breve pausa tra un punto e l’altro.

• Chi: quale persona o ruolo usa la funzione?
• Situazione iniziale: quali condizioni sono già presenti prima dell’azione?
• Azione: che cosa fa la persona?
• Risultato: che cosa deve poter osservare dopo?
• Eccezione: che cosa deve accadere in un caso di insuccesso rilevante?

Prima di un punto che il gruppo non ha ancora deciso, pronuncia «questione aperta». Durante la revisione potrai spostare quei passaggi in una sezione distinta, senza trasformare involontariamente un’ipotesi in un requisito.

3. Trasforma il dettato in affermazioni verificabili

Questo esempio è inventato e non descrive una funzionalità di TypeFree:

La persona che sta scrivendo ha aperto un articolo non pubblicato, con un titolo e del testo. Salva la bozza e vede una conferma. Quando la riapre, titolo e testo sono ancora presenti. L’articolo non deve diventare pubblico. Se il titolo è vuoto, bisogna chiedere di inserirlo e non salvare. Sul salvataggio automatico non abbiamo ancora deciso.

Dopo la dettatura, organizza il contenuto in una proposta da esaminare:

1. Il salvataggio riuscito di un articolo non pubblicato con il titolo compilato mostra una conferma alla persona che lo sta modificando.
2. Riaprendo la bozza salvata, vengono ripristinati il titolo e il corpo del testo di quel salvataggio.
3. Salvare la bozza non rende l’articolo visibile al pubblico.
4. Un tentativo di salvataggio con il titolo vuoto mostra un messaggio che richiede un titolo e non salva le modifiche.

Lascia «Il salvataggio automatico deve essere incluso?» tra le Questioni aperte, fuori dai criteri concordati. Queste regole sono proposte per una funzione immaginaria: il gruppo deve scegliere il comportamento del proprio prodotto.

4. Controlla il significato prima dello stile

Rileggi soprattutto parole come «non», «solo», «vuoto» e «non pubblicato». Una negazione mancante può capovolgere un requisito. Copia le etichette esatte dei pulsanti dal progetto grafico invece di affidarti soltanto alla trascrizione.

Poi considera ogni punto dal punto di vista di chi lo verificherà: quale azione devo compiere e quale risultato dimostrerebbe che il criterio è soddisfatto? Se hai scritto «salva rapidamente», chiarisci con il gruppo il tempo richiesto e le condizioni di misurazione. Non inventare una soglia solo per rendere la frase apparentemente precisa.

Separa i risultati visibili dalle idee di implementazione. Se parlando sei passato ai dettagli di archiviazione o ai nomi interni, sposta quei passaggi negli appunti tecnici da discutere.

5. Risolvi le questioni con il gruppo

Condividi i criteri come bozza e lascia visibili le decisioni ancora da prendere. Prima di considerare l’elenco come ambito concordato, chiedi alle persone che svilupperanno e verificheranno la funzione di esaminare gli scenari. La dettatura registra la tua spiegazione; non sostituisce l’accordo del gruppo e non dimostra che la funzione sia operativa.

Per altre attività di scrittura, consulta le guide su come preparare brief di progetto con la voce e scrivere segnalazioni di bug più chiare.

TypeFree è un modo semplice per trasformare la voce in testo modificabile e scrivere più velocemente. Scegli uno scenario, spiega il comportamento atteso e rileggi il testo prima di aggiungerlo all’attività.