Zet een Opname Om in een Rapport Waar Iemand Mee Aan de Slag Kan
Laad de schermopname van de bug. Speel het af, en elke keer dat er iets belangrijks gebeurt, markeer je het. De tijdstempel wordt vastgelegd, op dat moment wordt een frame uit de video gehaald, en de stap komt in een genummerde lijst.
Schrijf de samenvatting, wat je verwachtte en wat er in plaats daarvan gebeurde, en kopieer vervolgens het geheel als Markdown voor GitHub, Jira-opmaak of platte tekst. De browser- en schermdetails zijn al ingevuld.
De opname verlaat je machine nooit. Het wordt afgespeeld vanaf een lokaal bestand en frames worden op je apparaat getekend, wat belangrijk is wanneer de bug zich bevindt in een nog niet uitgebrachte build of het account van een klant.
Waarom Dit Geen AI Gebruikt om het Rapport te Schrijven
Een model dat een schermopname bekijkt, kan beschrijven wat het ziet. Het kan niet weten wat je verwachtte te zien, en dat is de helft van een bugrapport die bepaalt of iemand er actie op kan ondernemen.
“Op Bevestigen geklikt, het factuurpaneel was leeg” is een observatie. Of dat een bug is, hangt volledig af van wat daar had moeten verschijnen, en de enige persoon die dat weet ben jij. Een tool die verwacht gedrag genereert vanuit een video, raadt en presenteert die gok als een bevinding, wat erger is dan het veld leeg laten, omdat een aannemelijke verkeerde verwachting een ontwikkelaar op het verkeerde pad stuurt.
De splitsing hier is dus bewust. De tool doet het mechanische werk dat het precies kan doen: tijdstempels, frames, omgeving, opmaak, nummering. Jij levert het oordeel. Dat kost ongeveer een minuut en het resultaat is een rapport waar niemand meer op hoeft terug te komen.
De Drie Dingen Die Rapporten Meestal Missen
Na veel magere bugrapporten te hebben gelezen, komen dezelfde lacunes terug, en alle drie zijn ze mechanisch in plaats van moeilijk.
Tijdstempels. Een rapport dat zegt “zie de bijgevoegde video” laat de lezer vier minuten kijken om het moment te vinden. Een stap die zegt dat het om 1:12 gebeurde, doet dat niet.
Omgeving. Browser, besturingssysteem, schermgrootte. Iedereen weet dat je het moet toevoegen en bijna niemand doet het, omdat het betekent dat je een instellingenpaneel moet openen terwijl je midden in een gedachte zit. Het wordt hier uit je browser gelezen en staat al ingevuld in het rapport, en je kunt het corrigeren.
Stilstaande beelden. Een frame op het moment van falen is wat wordt gescand in een lijst van twintig problemen. Frames handmatig uit een video halen is zo vervelend dat mensen het overslaan, dus het gebeurt automatisch bij elke stap die je markeert.
Wat Er Precies Wordt Vastgelegd
Elke gemarkeerde stap registreert de exacte afspeeltijd en een JPEG-frame uit de video op dat moment, verkleind om het rapport licht te houden. Je kunt de frames downloaden om aan het probleem te bevestigen.
De omgeving komt van de browser: de naam en versie, het besturingssysteem, de schermgrootte met de pixelverhouding, en de viewportgrootte. Browsers rapporteren tegenwoordig minder over zichzelf dan vroeger, dus sommige hiervan kunnen onbekend terugkomen, en elk veld is bewerkbaar in plaats van vergrendeld.
Niets wordt afgeleid uit de pixels. De tool probeert geen fouttekst van het scherm te lezen of te raden op welk element je hebt geklikt, omdat het onbetrouwbaar doen ervan erger is dan het helemaal niet doen.
De Structuur Die Het Invult
De uitvoer volgt de vorm die een bugrapport heeft aangenomen, omdat trackers en de mensen die ze lezen dit verwachten. Als je op zoek bent naar een bugrapportsjabloon, dan is dit er een die al ingevuld aankomt in plaats van een die je plakt en waar je naar staart.
Eerst de samenvatting, in één regel, omdat die regel is wat iemand scant in een lijst van dertig problemen en het bepaalt of die van jou vandaag wordt geopend.
Vervolgens genummerde stappen met de tijdcode bij elke stap, verwacht gedrag, daadwerkelijk gedrag en de omgeving. Die volgorde is geen versiering. Een lezer controleert de stappen om te zien of het reproduceerbaar is, het verwachte en daadwerkelijke paar om te zien of het echt een bug is, en de omgeving om te zien of het de hunne is. Het begraven van een van die zaken kost een extra communicatieronde.
Wat een leeg sjabloon niet kan, is zichzelf invullen, wat het deel is dat mensen het laat overslaan. Hier komen de stappen, tijdcodes, frames en omgeving al ingevuld aan, en jij schrijft de drie velden die een tool echt niet kan weten.
Voordat u opneemt
Het rapport is slechts zo goed als de opname, en twee gewoonten maken het verschil.
Begin vanuit een bekende staat. Een opname die midden in een sessie begint, laat de lezer raden wat eraan voorafging, waardoor de stappen niet meer reproduceerbaar zijn. Begin bij een inlogscherm, een nieuwe pagina of een beschreven startpunt.
Maak het scherm vrij van alles wat niet mag ‘meereizen’. Tokens in een URL-balk, de naam van een klant, een ongerelateerde e-mail in een ander tabblad, een API-sleutel in een devtools-paneel. Een bugrapport wordt doorgestuurd, in een chat geplakt en gelezen door mensen buiten het team, en een schermopname draagt alles wat op dat moment op het scherm te zien was. Deze tool uploadt de video nooit, maar het rapport en de frames gaan overal naartoe waar u ze verzendt.
Wat het niet doet
Het dient de kwestie niet in. Er is geen verbinding met GitHub, Jira of iets anders; u kopieert het rapport en plakt het waar het hoort, wat ook betekent dat u het kunt lezen voordat iemand anders dat doet.
Het legt geen logs, netwerkverzoeken of console-uitvoer vast. Die leven in uw ontwikkelaarstools en zijn enorm belangrijk voor sommige bugs. Voeg ze toe via de veilige route die uw team al gebruikt, in plaats van een console te filmen.
En het diagnosticeert niets. Het zal u niet vertellen wat de oorzaak is, welk onderdeel de fout heeft veroorzaakt, of dit een duplicaat is van een bestaande kwestie. Het brengt het bewijsmateriaal in een vorm waar iemand mee kan werken, en dat is de hele taak.
De bug überhaupt opnemen
Als u het probleem nog steeds moet vastleggen, neemt de schermrecorder een tabblad, een venster of het hele scherm op in de browser. Voor een bug die u moet navertellen terwijl u reproduceert, neemt u op met audio en blijft de uitleg gekoppeld aan het bewijsmateriaal.
Twee handige functies. Als u losse afbeeldingen wilt in plaats van een rapport, haalt de video frame extractor frames op met intervallen. En als de opname lang is en u de gesproken uitleg als tekst wilt, zet de transcript generator de gesproken tekst om in iets doorzoekbaars.
