Bugrapportgenerator

Maak van een opname een rapport waar iemand actie op kan ondernemen

Laad de schermopname van de bug. Speel deze af, en markeer telkens wanneer er iets belangrijks gebeurt. De tijdstempel wordt vastgelegd, er wordt op dat moment een frame uit de video gehaald en de stap wordt toegevoegd aan een genummerde lijst.

Schrijf de samenvatting, wat je verwachtte en wat er in plaats daarvan gebeurde, en kopieer het geheel vervolgens als Markdown voor GitHub, Jira-markup of platte tekst. De browser- en schermdetails zijn al ingevuld.

De opname verlaat je apparaat nooit. Deze wordt afgespeeld vanaf een lokaal bestand en frames worden op je apparaat gegenereerd, wat belangrijk is wanneer de bug zich in een nog niet uitgebrachte build of het account van een klant bevindt.

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 je opneemt

Het rapport is slechts zo goed als de opname, en twee gewoonten maken het verschil.

Begin vanuit een bekende staat. Een opname die halverwege een sessie begint, laat de lezer raden naar wat eraan voorafging, waardoor de stappen niet meer reproduceerbaar zijn. Begin bij een inlogscherm, een nieuwe pagina of een beschreven beginpunt.

Verwijder alles van het scherm dat niet gedeeld mag worden. Tokens in een URL-balk, de naam van een klant, een niet-gerelateerde e-mail in een ander tabblad, een API-sleutel in een ontwikkelaarstools-venster. Een bugrapport wordt doorgestuurd, in een chat geplakt en gelezen door mensen buiten het team, en een schermopname toont alles wat er op dat moment op het scherm te zien was. Deze tool uploadt de video nooit, maar het rapport en de frames belanden overal waar je ze naartoe stuurt.

Wat het niet doet

Het meldt het probleem niet aan. Er is geen verbinding met GitHub, Jira of iets anders; je kopieert het rapport en plakt het waar het thuishoort, wat ook betekent dat je het eerst zelf kunt nalezen voordat iemand anders het ziet.

Het legt geen logs, netwerkverzoeken of console-uitvoer vast. Die bevinden zich in je ontwikkelaarstools en zijn voor sommige bugs enorm belangrijk. Voeg ze toe via de beveiligde route die je team al gebruikt, in plaats van een console te filmen.

En het stelt geen diagnoses. Het vertelt je niet wat de oorzaak is, welk onderdeel faalt of of dit een duplicaat is van een bestaand probleem. Het brengt het bewijsmateriaal in een vorm waar iemand mee aan de slag kan, en dat is de hele taak.

De bug om te beginnen opnemen

Als je het probleem nog moet vastleggen, neemt de schermrecorder een tabblad, een venster of het volledige scherm op in de browser. Voor een bug die je mondeling wilt toelichten terwijl je deze reproduceert, neem je op met audio, zodat de uitleg aan het bewijsmateriaal gekoppeld blijft.

Twee verwante tools die het waard zijn om te kennen. Als je losse afbeeldingen wilt in plaats van een rapport, haalt de videoframes-extractor met intervallen frames op. En als de opname lang is en je het gesproken stappenplan als tekst wilt, zet de transcriptiegenerator de gesproken toelichting om in iets doorzoekbaars.

Stel vragen aan de opname over de bug

De controle op deze pagina draait op je apparaat en vereist geen account. Voor antwoorden over wat er in de opname is gezegd of getoond, upload je deze naar ScreenApp. Klik op een vraag om ScreenApp te openen waarin deze vraag al klaarstaat.

In ScreenApp, door op een moment in de transcriptie te klikken, springt de speler naar dat punt in de opname, zodat je elk antwoord kunt controleren aan de hand van de opname.

Wat elk abonnement hier doet

De tool op deze pagina is gratis en blijft gratis. Een account is bedoeld voor de stap ervoor of de stap erna.