Generatore di segnalazioni di bug

Trasforma una registrazione in un report subito utilizzabile

Carica la registrazione dello schermo del bug. Avviala e, ogni volta che accade qualcosa di rilevante, segnalalo. Il timestamp viene registrato, viene acquisito un fotogramma dal video in quel momento esatto e il passaggio viene inserito in un elenco numerato.

Scrivi il riassunto, ciò che ti aspettavi e ciò che è accaduto invece, poi copia l’intero report in formato Markdown per GitHub, markup Jira o testo normale. I dettagli su browser e schermo sono già compilati.

La registrazione non lascia mai il tuo computer. Viene riprodotta da un file locale e i fotogrammi vengono estratti sul tuo dispositivo, un aspetto fondamentale quando il bug riguarda una versione non ancora rilasciata o l’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

La qualità del report dipende da quella della registrazione, e due buone abitudini fanno la differenza.

Inizia da uno stato noto. Una registrazione che inizia a metà sessione costringe chi legge a tirare a indovinare cosa sia successo prima, rendendo i passaggi non riproducibili. Comincia da una schermata di accesso, da una nuova pagina o da un punto di partenza ben definito.

Rimuovi dallo schermo tutto ciò che non dovrebbe essere condiviso: token nella barra degli indirizzi, nomi di clienti, email non pertinenti in un’altra scheda, chiavi API nel pannello degli strumenti per sviluppatori. Una segnalazione di bug viene inoltrata, incollata in chat e letta da persone esterne al team, e una registrazione dello schermo mostra tutto ciò che era visibile in quel momento. Questo strumento non carica mai il video, ma il report e i fotogrammi andranno ovunque tu decida di inviarli.

Cosa non fa

Non invia la segnalazione. Non c’è alcun collegamento con GitHub, Jira o altre piattaforme: copi il report e lo incolli dove serve, il che ti consente anche di rileggerlo prima che lo veda chiunque altro.

Non acquisisce log, richieste di rete o output della console. Questi elementi risiedono negli strumenti per sviluppatori e sono fondamentali per alcuni bug. Allegali tramite i canali sicuri già utilizzati dal tuo team, anziché registrare a video la console.

E non esegue alcuna diagnosi. Non ti dirà la causa, quale componente sia difettoso o se si tratti di un duplicato di una issue esistente. Il suo unico scopo è organizzare le prove in modo chiaro, così che qualcuno possa lavorarci.

Come registrare il bug fin dall’inizio

Se devi ancora registrare il problema, lo screen recorder registra una scheda, una finestra o l’intero schermo direttamente dal browser. Per un bug che necessita di spiegazioni vocali durante la riproduzione, registra con l’audio: in questo modo la spiegazione rimarrà allegata alla prova.

Altri due strumenti utili da conoscere: se desideri singole immagini anziché un report, l’estrattore di fotogrammi video estrae fotogrammi a intervalli regolari. Se invece la registrazione è lunga e desideri il resoconto vocale sotto forma di testo, il generatore di trascrizioni trasforma il parlato in testo ricercabile.

Fai domande alla registrazione sul bug

L’analisi su questa pagina viene eseguita sul tuo dispositivo e non richiede alcun account. Per ottenere risposte su ciò che è stato detto o mostrato nella registrazione, caricala su ScreenApp. Fai clic su una domanda per aprire ScreenApp con la richiesta già pronta.

In ScreenApp, cliccando un momento nella trascrizione il lettore salta a quel punto della registrazione, così potrai verificare qualsiasi risposta confrontandola con la registrazione.

A cosa serve ciascun piano

Lo strumento su questa pagina è gratuito e rimarrà gratuito. L’account serve per il passaggio precedente o per quello successivo.