Come registrare chiari report sui bug usando Loom

I PRINCIPALI PUNTI SALIENTI

Una breve registrazione Loom mostra agli sviluppatori esattamente cosa sta succedendo, senza bisogno di lunghe spiegazioni scritte e senza possibilità di fraintendimenti.
Illustrare ogni passaggio mentre lo si descrive significa che tutti possono seguire e comprendere immediatamente il problema.
Mettere in evidenza la gravità, l'impatto e il comportamento previsto nella registrazione fornisce agli sviluppatori tutto ciò di cui hanno bisogno per prioritizzare e correggere il problema.
Loom acquisisce automaticamente le informazioni su browser, dispositivo, log della console e rete, di conseguenza si riducono i continui scambi di comunicazioni tra chi segnala i problemi e i team di sviluppo.
Inserisci il link di Loom in Slack, e-mail o Jira e lascia che i membri del team guardino e commentino il video quando sono più comodi, senza bisogno di partecipare a riunioni.

Acquisisci report sui bug chiari e attuabili con Loom

Se hai mai provato a scrivere un report su un bug, sai quanti dettagli rischiano di andare persi. È raro riuscire a descrivere i passaggi, il messaggio di errore e quello che stavi facendo nel momento esatto in cui si è verificato un problema includendo tutti i dettagli che uno sviluppatore ha bisogno di conoscere.

Quindi, cos'è un report su un bug nello sviluppo software? Un report su un bug è un documento scritto o registrato che acquisisce esattamente cosa è andato storto, come riprodurre il problema e qual era il comportamento previsto. L'obiettivo è fornire agli sviluppatori informazioni sufficienti per comprendere, prioritizzare e risolvere il problema senza continui scambi di comunicazioni.

La creazione di report tramite video Loom rende questo processo notevolmente più veloce. Invece di scrivere un blocco di testo, registri la tua schermata, illustri il problema e condividi un link. Questo aiuta ad allineare i team in modo rapido e senza confusione. Prosegui nella lettura per scoprire come acquisire report sui bug che forniscano al tuo team tutto ciò di cui ha bisogno per risolvere rapidamente i problemi.

Passaggio 1. Determina il bug da segnalare

Prima di far partire la registrazione, dedica un attimo a verificare di poter riprodurre il problema in modo affidabile. Un bug che si è verificato solo una volta e non può essere riprodotto è molto più difficile da analizzare per un team di sviluppo.

Pensa a qual è il comportamento previsto e cosa, invece, si sta effettivamente verificando. Questo contrasto è al centro di qualsiasi utile report sui bug. Una volta che hai ben presente questo aspetto, vai alla sezione del prodotto in cui si verifica il bug, così da poterlo acquisire nel contesto.

Passaggio 2. Inizia a registrare il contenuto dello schermo con Loom

Apri Loom e scegli se registrare solo ciò che è visualizzato sullo schermo oppure anche la tua immagine. La registrazione dei soli contenuti dello schermo è perfetta per la maggior parte dei bug. Aggiungere la tua immagine ripresa dalla videocamera può essere utile se stai spiegando qualcosa a uno stakeholder non tecnico o vuoi aggiungere un tocco di contesto personale.

Seleziona la finestra o la scheda specifica in cui appare il bug. Se mantieni la registrazione limitata all'area giusta, aiuti chi guarda a seguire senza lasciarsi distrarre da altre finestre aperte o da contenuti non correlati.

Passaggio 3. Riproduci e registra i passaggi che causano il bug

Questa è la parte più importante della registrazione. Esamina ogni azione che causa il problema e illustra ciò che si verifica. Spiega su cosa stai cliccando, cosa ti aspetti che accada e cosa invece vedi.

Muoviti con calma. Potresti avere la tentazione di coprire velocemente i passaggi che conosci bene, ma chi sta guardando potrebbe vederli per la prima volta. Se rallenti, meno persone dovranno tornare a rivedere i passaggi per riuscire a seguirti.

Passaggio 4. Segnala il bug e descrivi qual è il problema

Quando il bug appare sullo schermo, metti in pausa e fallo notare chiaramente. Non dare per scontato che sia evidente. Descrivi esattamente cosa non funziona o è errato e qual è, invece, il comportamento atteso.

Questo è il momento in cui la registrazione diventa davvero utile per i team di sviluppo software. Una narrazione chiara nel momento esatto in cui si verifica il problema evita agli sviluppatori di dover interpretare timestamp vaghi o di dover indovinare a cosa si riferiva chi ha segnalato il bug.

Passaggio 5. Metti in risalto l'impatto e la gravità durante la registrazione

Dopo aver mostrato il bug, prenditi un attimo per spiegare chi è interessato dal problema e come interrompe il flusso di lavoro o l'esperienza. Un bug che impedisce a un utente di completare il pagamento è una cosa ben diversa da un problema di visualizzazione di minore entità.

Indica con quale frequenza si verifica, se blocca totalmente l'attività e se esistono soluzioni note. Queste informazioni aiutano a definire la priorità della correzione.

In questo caso, sono utili anche le funzionalità di Loom per commentare e aggiungere reazioni. Puoi inserire un commento con timestamp nel punto esatto in cui appare il bug, in modo che chiunque stia seguendo possa andare direttamente a quel punto senza bisogno di scorrere l'intero video.

Loom, inoltre, acquisisce automaticamente il contesto tecnico, tra cui tipo di browser, dispositivo, log della console e dettagli di rete, che serve agli sviluppatori per risolvere i problemi. Questo evita il solito giro di domande di follow-up tra la persona che ha segnalato il bug e il team che lo risolve.

Passaggio 6. Rivedi, ritocca e perfeziona il report sul bug con Loom IA

Prima di condividere il video, riguardalo. Verifica se c'è qualcosa di poco chiaro e rimuovi le pause non necessarie o i tempi morti accidentali. Un video più conciso è più facile da seguire e aiuta a capire come agire.

L'IA di Loom semplifica il tutto. Tutti possono creare una registrazione precisa e professionale, anche chi non ha esperienza nell'editing video. Le modifiche basate sull'IA sistemano tutto automaticamente e questo è utile soprattutto ai membri del team che non si sentono a proprio agio davanti alla telecamera ma devono comunque comunicare chiaramente.

Passaggio 7. Condividi la registrazione con i membri del team in modo che possano vederla quanto preferiscono

Copia il link di Loom e inseriscilo ovunque lavori il tuo team, ad esempio in Slack, nelle e-mail o direttamente nello strumento di monitoraggio dei bug.

Se il tuo team usa Jira, con Loom il passaggio è ancora più fluido. Nella scheda Generate (Genera), c'è il pulsante "Create in Jira" (Crea in Jira) che ti consente di creare un ticket direttamente nella board Jira del tuo team senza bisogno di uscire da Loom. Il video, il contesto e i dettagli portano direttamente dove viene svolto il lavoro.

Qui i membri del team possono guardare, commentare e allinearsi attraverso la comunicazione asincrona senza bisogno di pianificare riunioni. Lavoro asincrono con Loom significa che i team distribuiti possono rivedere, discutere e allinearsi sui problemi nel momento che preferiscono, accelerando i cicli di feedback e riducendo le riunioni non necessarie.

Quali sono gli elementi chiave da includere quando si registra la segnalazione di bug?

Un video di segnalazione dei bug efficace deve avere i seguenti elementi:

Passaggi di riproduzione chiari. Descrivi ogni azione che genera il bug, in modo che gli sviluppatori possano riprodurre i passaggi senza dover fare congetture.
Comportamento visibile. Mostra ciò che succede effettivamente sulla schermata anziché limitarti a descriverlo a parole.
Risultati previsti e risultati effettivi. Indica chiaramente qual era il comportamento previsto e qual è stato quello effettivo, in modo da rendere il problema immediatamente comprensibile.
Contesto relativo a impatto e gravità. Spiega quali persone sono interessate dal bug e quanto è problematico, in modo che il team possa prioritizzarlo di conseguenza.
Dettagli ambientali. Loom ottiene automaticamente le informazioni sul browser e sul dispositivo. Tuttavia, può essere comunque utile specificare il sistema operativo, la versione dell'app o il tipo di account quando pertinente.

Quando registrare una segnalazione del bug con Loom

Non tutte le segnalazioni di bug richiedono un video Loom. Tuttavia, ci sono situazioni in cui una registrazione della schermata è molto più efficace delle sole note scritte. Ecco alcuni scenari reali in cui può essere utile registrare una segnalazione di bug:

Quando devi mostrare i passaggi da riprodurre esatti, ma non puoi chiamare la persona interessata in quel momento. Ad esempio, se lavori in un fuso orario diverso oppure il bug è difficile da spiegare per iscritto.
Quando gli sviluppatori/il controllo di qualità rimangono bloccati in un loop di commenti. Una persona scrive ciò che ha visto e un'altra cerca di riprodurre i passaggi per visualizzare il bug, ma non ci riesce.
Quando chi segnala i problemi senza avere competenze tecniche deve mostrare in modo chiaro ciò che vede. Un membro del team Customer Success o di marketing non deve necessariamente conoscere la terminologia corretta per effettuare una segnalazione utile di un bug.
Quando un bug si verifica solo in condizioni specifiche. Se il problema si manifesta dopo una particolare sequenza di clic o solo con determinate autorizzazioni utente, mostrarlo è più veloce che descriverlo.
Quando ci sono problemi di natura visiva. I problemi di layout, gli errori di rendering o i glitch delle animazioni sono quasi impossibili da spiegare accuratamente per iscritto.
Quando segnali bug intermittenti. Se il problema non si verifica ogni volta, registrarlo in video quando si presenta offre al team qualcosa di concreto su cui lavorare.
Quando il bug riguarda più passaggi su schermate o schede diverse. È più facile seguire un flusso di lavoro complesso in un video che in un elenco numerato.

Suggerimenti per registrare correttamente una segnalazione di bug con Loom

Alcune abitudini contribuiscono molto a rendere le tue segnalazioni di bug più utili. Questi suggerimenti si applicano sia alla prima segnalazione che fai sia alla centesima:

Mantieni la concentrazione. Registra un bug per video quando possibile. Se raggruppi più problemi nella stessa registrazione, per gli sviluppatori risulterà più difficile eseguire i test e assegnare il lavoro.
Descrivi le azioni che svolgi: non limitarti a fare clic sulle voci: spiega cosa stai facendo e perché. Commentare ogni passaggio rende la registrazione utile per chi non ha un contesto pregresso.
Usa i movimenti del cursore con cognizione. Muovi il mouse per attirare l'attenzione sull'area interessata. Passando il mouse attorno al bug quando appare, chi guarda può seguire con maggiore attenzione i punti di interesse.
Scrivi un titolo chiaro. Un titolo come "Pulsante checkout non risponde dopo applicazione codice promozionale – Safari" è molto più utile di "Bug durante il checkout". Dei titoli chiari aiutano i team a cercare, ordinare e prioritizzare senza dover aprire ogni video.

Loom è uno dei migliori strumenti di segnalazione di bug disponibili e si integra con gli strumenti di documentazione software per mantenere tutto organizzato in un unico posto.

Risolvi i bug più velocemente con le segnalazioni visive

Le descrizioni scritte dei bug rallentano tutti. Chi compila il report ha difficoltà a registrare tutto. Chi sviluppa e legge il codice deve fare congetture in base ai dettagli a disposizione. E il collega del team del controllo di qualità che cerca di riprodurlo spesso non ci riesce. Una breve registrazione Loom sostituisce tutti questi passaggi con un contenuto che qualsiasi membro del team può guardare rapidamente. Il registratore dello schermo di Loom consente di catturare facilmente il problema, aggiungere una procedura dettagliata in stile presentazione video e condividere il contenuto all'istante.

Condividi la registrazione una volta e il tuo team avrà tutto ciò di cui ha bisogno: non servirà nessuna telefonata di follow-up, nessuna e-mail di chiarimento e nessuna attesa che qualcuno sia disponibile.

Ottieni Loom gratis