“L’app non va” non aiuta a distinguere un crash da un rallentamento o da un dato che non si salva. Scrivi il risultato che dovrebbe accadere e quello che succede: per esempio, “Esportazione PDF: il file resta vuoto dopo aver scelto A4”. Se conosci il punto del flusso, aggiungilo. Non anticipare una causa che non hai verificato: “database rotto” è un’ipotesi, non un sintomo.
Perché è importante
- Un titolo preciso e una sequenza di passaggi permettono a chi legge di capire e tentare di riprodurre il problema.
- Versione, dispositivo, orario, frequenza e differenza tra risultato atteso e osservato aiutano a distinguere un guasto isolato da un caso ripetibile.
- Screenshot, log e registrazioni possono contenere dati personali, token o informazioni aziendali: vanno controllati e condivisi solo attraverso il canale previsto.
Parti da un titolo che descriva il sintomo
Prima di aprire una nuova segnalazione, cerca nel canale di assistenza o nel sistema condiviso se qualcuno ha già registrato lo stesso comportamento. Se trovi un caso simile, aggiungi una prova o una condizione nuova invece di creare un duplicato.
Scrivi i passaggi minimi per riprodurlo
Usa un elenco numerato e parti da uno stato chiaro: dispositivo e app aperti, schermata iniziale o file di prova. Aggiungi un’azione per riga, quindi indica il risultato atteso e quello reale. Se un passaggio dipende da un dato, usa un esempio non sensibile. Chi legge dovrebbe poter tentare la stessa sequenza senza chiederti cosa intendevi.
Indica quanto spesso accade e in quale contesto: sempre, una volta su cinque, solo dopo una modifica o soltanto con una rete specifica. Registra data, ora e fuso orario; non ripetere operazioni che potrebbero inviare, cancellare o pubblicare dati reali. Se non puoi riprodurlo in sicurezza, dichiaralo chiaramente.
Cosa puoi farci concretamente
- Descrivi in una frase il risultato atteso e quello osservato; aggiungi il messaggio d’errore esatto senza interpretarlo.
- Elenca i passaggi minimi, numerati, e annota app, versione, dispositivo, orario con fuso e frequenza. Indica se il problema si ripete dopo una riapertura, senza provare modifiche rischiose.
- Allega una sola prova utile, ritagliata o oscurata per rimuovere nomi, email, notifiche e dati riservati. Usa il canale ufficiale e indica l’impatto e un contatto per la risposta.
Aggiungi la versione e l’impatto
Per un problema software, annota nome e versione dell’app, sistema operativo e versione, modello del dispositivo se rilevante, browser e rete quando incidono sul comportamento. Non servono dati personali del tuo account per descrivere un errore comune: inserisci solo l’identificativo tecnico richiesto dal canale autorizzato.
Spiega chi è bloccato e quale lavoro non può proseguire. “Impedisce di inviare le fatture a tre persone” comunica più di “gravissimo”; separa l’impatto osservato dalla priorità che proponi. Specifica se esiste una soluzione temporanea, senza presentarla come risoluzione definitiva.
4. Condividi una prova sicura e invia la segnalazione
Uno screenshot può rendere chiaro un difetto visivo, mentre una registrazione breve può mostrare una sequenza difficile da descrivere. Prima dell’invio controlla l’intera immagine: barra del browser, notifiche, nomi, indirizzi, dati cliente e schede aperte possono rivelare più del problema. Ritaglia o oscura le parti non necessarie e, se possibile, riproduci il caso con dati di test.
Log e diagnostica possono includere identificatori, percorsi o contenuti. Usa solo il portale o il sistema di ticket previsto dall’organizzazione o dal produttore; non allegare file sensibili a una chat pubblica. Chiedi al referente quale canale è autorizzato se la prova contiene dati protetti.
Modello rapido: titolo e sintomo; risultato atteso e osservato; passaggi numerati; data, ora e fuso; frequenza; app e versioni; dispositivo e rete pertinenti; impatto e soluzione temporanea; prova allegata e dati rimossi. Una buona segnalazione non è lunga per forza: contiene le informazioni che cambiano la diagnosi. Dopo l’invio, aggiungi nuovi tentativi allo stesso record invece di aprire una catena di messaggi.
Fonti
Documenti, comunicati e pubblicazioni consultati per ricostruire dati e contesto.
