Trasforma una Registrazione in un Report su Cui Qualcuno Può Agire
Carica la registrazione dello schermo del bug. Riproducila e, ogni volta che succede qualcosa di importante, segnalo. Il timestamp viene catturato, un fotogramma viene estratto dal video in quel momento e il passaggio entra in un elenco numerato.
Scrivi il riepilogo, cosa ti aspettavi e cosa è successo invece, quindi copia l’intero contenuto come Markdown per GitHub, markup Jira o testo semplice. I dettagli del browser e dello schermo sono già compilati.
La registrazione non lascia mai la tua macchina. Viene riprodotta da un file locale e i fotogrammi vengono disegnati sul tuo dispositivo, il che è importante quando il bug si trova in una build non rilasciata o nell’account di un cliente.
Perché Questo Non Usa l’IA per Scrivere il Report
Un modello che osserva una registrazione dello schermo può descrivere ciò che vede. Non può sapere cosa ti aspettavi di vedere, e questa è la metà di un bug report che decide se qualcuno può agire su di esso.
“Cliccato Conferma, il pannello della fattura era vuoto” è un’osservazione. Se si tratti di un bug dipende interamente da cosa avrebbe dovuto apparire lì, e l’unica persona che lo sa sei tu. Uno strumento che genera il comportamento atteso da un video sta indovinando e presentando l’ipotesi come un riscontro, il che è peggio che lasciare il campo vuoto, perché un’aspettativa errata plausibile invia uno sviluppatore sulla strada sbagliata.
Quindi la divisione qui è deliberata. Lo strumento svolge il lavoro meccanico che può fare esattamente: timestamp, fotogrammi, ambiente, formattazione, numerazione. Tu fornisci il giudizio. Ci vuole circa un minuto e il risultato è un report su cui nessuno deve tornare da te.
Le Tre Cose che i Report Solitamente Mancano
Avendo letto molti report di bug scarni, le stesse lacune si ripresentano, e tutte e tre sono meccaniche piuttosto che difficili.
Timestamp. Un report che dice “vedi il video allegato” costringe il lettore a guardare quattro minuti per trovare il momento. Un passo che dice che è successo all’1:12 no.
Ambiente. Browser, sistema operativo, dimensione dello schermo. Tutti sanno che va incluso e quasi nessuno lo fa, perché significa aprire un pannello delle impostazioni mentre si è nel mezzo di un pensiero. Viene letto dal tuo browser qui e si trova già compilato nel report, e puoi correggerlo.
Immagini fisse. Un fotogramma al momento del fallimento è ciò che viene scansionato in un elenco di venti problemi. Estrarre fotogrammi da un video a mano è abbastanza noioso che le persone lo saltano, quindi avviene automaticamente ad ogni passo che segnali.
Cosa Viene Acquisito, Precisamente
Ogni passaggio contrassegnato registra l’ora esatta di riproduzione e un fotogramma JPEG dal video in quel momento, ridimensionato per mantenere il report leggero. Puoi scaricare i fotogrammi per allegarli al problema.
L’ambiente proviene dal browser: il suo nome e versione, il sistema operativo, la dimensione dello schermo con il suo pixel ratio e la dimensione della viewport. I browser ora riportano meno informazioni su se stessi rispetto a prima, quindi alcuni di questi dati possono risultare sconosciuti, e ogni campo è modificabile piuttosto che bloccato.
Nulla viene inferito dai pixel. Lo strumento non tenta di leggere il testo di errore dallo schermo o indovinare su quale elemento hai cliccato, perché farlo in modo inaffidabile è peggio che non farlo.
La Struttura che Compila
L’output segue la forma su cui si è assestato un bug report, perché i tracker e le persone che li leggono se lo aspettano. Se stavi cercando un modello di bug report, questo è uno che arriva già compilato piuttosto che uno che incolli e fissi.
Riepilogo per primo, in una singola riga, perché quella riga è ciò che qualcuno scandisce in un elenco di trenta problemi e decide se il tuo viene aperto oggi.
Poi passi numerati con il timecode su ciascuno, comportamento atteso, comportamento effettivo e l’ambiente. Quest’ordine non è una decorazione. Un lettore controlla i passaggi per vedere se è riproducibile, la coppia atteso e effettivo per vedere se è davvero un bug, e l’ambiente per vedere se è il loro. Nascondere uno di questi comporta un viaggio di andata e ritorno.
Quello che un modello vuoto non può fare è compilarsi da solo, che è la parte che fa sì che le persone lo saltino. Qui i passaggi, i timecode, i fotogrammi e l’ambiente arrivano popolati, e tu scrivi i tre campi che uno strumento non può sinceramente conoscere.
Prima di Registrare
Il report è valido solo quanto la registrazione, e due abitudini fanno la differenza.
Inizia da uno stato conosciuto. Una registrazione che inizia a metà sessione lascia il lettore a indovinare cosa sia successo prima, quindi i passaggi smettono di essere riproducibili. Inizia da una schermata di login, una pagina nuova o un punto di partenza descritto.
Pulisci lo schermo da qualsiasi cosa che non dovrebbe essere inclusa. Token nella barra degli URL, il nome di un cliente, un’e-mail non correlata in un’altra scheda, una chiave API in un pannello degli strumenti per sviluppatori. Un bug report viene inoltrato, incollato in chat e letto da persone al di fuori del team, e una registrazione dello schermo porta con sé tutto ciò che era sullo schermo in quel momento. Questo strumento non carica mai il video, ma il report e i fotogrammi vanno ovunque tu li invii.
Cosa Non Fa
Non archivia il problema. Non c’è connessione a GitHub, Jira o altro; copi il report e lo incolli dove deve andare, il che significa anche che puoi leggerlo prima di chiunque altro.
Non cattura log, richieste di rete o output della console. Questi si trovano nei tuoi strumenti per sviluppatori e sono estremamente importanti per alcuni bug. Allegali tramite la via sicura che il tuo team già utilizza, piuttosto che filmare una console.
E non diagnostica nulla. Non ti dirà la causa, quale componente è difettoso o se questo duplica un problema esistente. Raccoglie le prove in una forma da cui qualcuno può lavorare, e questo è tutto il suo compito.
Registrare il Bug in Primo Luogo
Se hai ancora bisogno di catturare il problema, lo registratore dello schermo registra una scheda, una finestra o l’intero display nel browser. Per un bug che devi narrare mentre riproduci, registra con audio e la spiegazione rimarrà allegata alla prova.
Due strumenti utili da conoscere. Se desideri singole immagini anziché un report, l’estrattore di fotogrammi video estrae fotogrammi a intervalli. E se la registrazione è lunga e desideri la descrizione vocale come testo, il generatore di trascrizioni trasforma la narrazione in qualcosa di ricercabile.
