Come fare screenshot utili per segnalare un bug su Mac

Lo screenshot di una schermata malfunzionante lascia alcune domande aperte: quale azione ha causato il problema, cosa sarebbe dovuto succedere e se accade ogni volta. Accompagna l’immagine mirata con una breve spiegazione, così chi indaga può riprodurre il problema.

Ecco un flusso pratico per segnalare un problema in un’app per Mac o su un sito web, con un modello da copiare in un sistema di tracciamento dei bug o in un messaggio all’assistenza.

1. Includi abbastanza contesto nell’immagine

Quando possibile, acquisisci insieme il controllo che non funziona e il risultato. Se il pulsante Salva genera un errore, includi il pulsante, l’errore e la parte rilevante del modulo. Un’intera scrivania rende difficile trovare i dettagli piccoli; un messaggio di errore isolato potrebbe nascondere la schermata che l’ha generato.

Usa dati di esempio per riprodurre il problema. Ritaglia le schede non pertinenti e i dati dell’account. È meglio rimuovere credenziali e valori privati alla fonte prima di acquisire lo schermo: una leggera sfocatura non è un modo affidabile per nascondere il testo.

La cattura di un’area di Floatie mantiene il risultato fluttuante mentre torni nell’app per verificare i passaggi. Fai un’altra acquisizione se serve uno stato diverso per spiegare la sequenza.

2. Evidenzia ciò che hai osservato, poi spiegalo

Spesso basta una freccia verso il controllo che non funziona. Usa richiami numerati quando chi legge deve seguire un ordine e aggiungi la spiegazione accanto all’allegato. Non disegnare sopra il testo esatto dell’errore o il valore che dimostra il bug.

Con una cattura Floatie attiva, ⌘E apre l’editor Pro per aggiungere frecce, testo e indicatori numerati. La pagina della funzione di modifica ne presenta gli strumenti.

Se l’errore esiste solo come immagine, l’OCR può aiutare a copiarne il testo (in inglese). Confronta il testo copiato con l’originale, soprattutto la punteggiatura e i caratteri simili. Inserisci nel rapporto anche il testo dell’errore, così sarà ricercabile oltre che visibile nell’immagine.

3. Aggiungi questo modello per riprodurre il problema

L’esempio seguente è fittizio; sostituiscilo con le tue osservazioni.

Titolo: Salva resta disattivato dopo aver inserito il nome del progetto

Ambiente:
- App e versione:
- Versione di macOS:
- Browser e versione, se pertinente:

Passaggi:
1. Apri un nuovo progetto.
2. Inserisci un nome.
3. Prova a selezionare Salva.

Previsto: Salva diventa disponibile dopo l’inserimento di un nome valido.
Effettivo: Salva resta disattivato.
Frequenza: Riprodotto in 3 tentativi su 3.
Allegato: salva-progetto-disattivato.png

Nel campo frequenza, indica cosa hai effettivamente provato. Se è successo una sola volta, scrivilo. Per un problema di impaginazione di un sito, includi le dimensioni della finestra o il livello di zoom se influiscono sul risultato.

4. Scegli tra screenshot e registrazione

Uno screenshot va bene per un valore errato, un’etichetta mancante o un layout difettoso. Una breve registrazione è più utile se un menu scompare, la pagina scorre in modo imprevisto o serve mostrare una sequenza di clic. Registra solo la parte pertinente dello schermo (in inglese) e interrompi la registrazione quando il comportamento è visibile.

Allega il file alla segnalazione se deve rimanere disponibile insieme al rapporto. Prima di inviarlo, apri l’allegato e controlla che il testo importante sia leggibile. Se il limite di dimensione è un problema, riduci le dimensioni dello screenshot mantenendo leggibile quel dettaglio.

Prova Floatie per la prossima segnalazione di bug