Eine Aufzeichnung in einen handlungsrelevanten Bericht verwandeln
Laden Sie die Bildschirmaufzeichnung des Fehlers. Spielen Sie sie ab und markieren Sie jedes Mal, wenn etwas Wichtiges geschieht. Der Zeitstempel wird erfasst, ein Frame wird in diesem Moment aus dem Video entnommen, und der Schritt wird in eine nummerierte Liste eingefügt.
Schreiben Sie die Zusammenfassung, was Sie erwartet haben und was stattdessen passiert ist, und kopieren Sie das Ganze dann als Markdown für GitHub, Jira-Markup oder einfachen Text heraus. Die Browser- und Bildschirmdetails sind bereits ausgefüllt.
Die Aufzeichnung verlässt niemals Ihren Computer. Sie wird von einer lokalen Datei abgespielt und Frames werden auf Ihrem Gerät gezeichnet, was wichtig ist, wenn der Fehler in einem unveröffentlichten Build oder einem Kundenkonto auftritt.
Warum dies keine KI zur Berichterstellung verwendet
Ein Modell, das eine Bildschirmaufzeichnung beobachtet, kann beschreiben, was es sieht. Es kann nicht wissen, was Sie erwartet haben, und das ist die Hälfte eines Fehlerberichts, die darüber entscheidet, ob jemand darauf reagieren kann.
“Bestätigen geklickt, das Rechnungsfeld war leer” ist eine Beobachtung. Ob das ein Fehler ist, hängt ausschließlich davon ab, was dort hätte erscheinen sollen, und die einzige Person, die das weiß, sind Sie. Ein Tool, das erwartetes Verhalten aus einem Video generiert, rät und präsentiert die Vermutung als Ergebnis, was schlimmer ist, als das Feld leer zu lassen, da eine plausible falsche Erwartung einen Entwickler auf den falschen Weg führt.
Die Aufteilung hier ist also bewusst. Das Tool erledigt die mechanische Arbeit, die es genau ausführen kann: Zeitstempel, Frames, Umgebung, Formatierung, Nummerierung. Sie liefern die Beurteilung. Das dauert etwa eine Minute, und das Ergebnis ist ein Bericht, zu dem Sie niemand mehr befragen muss.
Die drei Dinge, die Berichte normalerweise übersehen
Nachdem ich viele magere Fehlerberichte gelesen habe, treten immer wieder dieselben Lücken auf, und alle drei sind eher mechanischer als schwieriger Natur.
Zeitstempel. Ein Bericht, der besagt “siehe das angehängte Video”, zwingt den Leser, vier Minuten lang zuzusehen, um den Moment zu finden. Ein Schritt, der angibt, dass es um 1:12 Uhr geschah, tut dies nicht.
Umgebung. Browser, Betriebssystem, Bildschirmgröße. Jeder weiß, dass es dazugehört, und fast niemand tut es, weil es bedeutet, ein Einstellungsfeld zu öffnen, während man gerade in Gedanken versunken ist. Es wird hier aus Ihrem Browser gelesen und ist bereits im Bericht ausgefüllt, und Sie können es korrigieren.
Standbilder. Ein Frame zum Zeitpunkt des Fehlers ist das, was in einer Liste von zwanzig Problemen gescannt wird. Frames manuell aus einem Video zu ziehen, ist mühsam genug, dass die Leute es überspringen, daher geschieht es automatisch bei jedem Schritt, den Sie markieren.
Was genau erfasst wird
Jeder markierte Schritt zeichnet die exakte Wiedergabezeit und einen JPEG-Frame aus dem Video zu diesem Zeitpunkt auf, verkleinert, um den Bericht leicht zu halten. Sie können die Frames herunterladen, um sie dem Problem anzuhängen.
Die Umgebung stammt vom Browser: dessen Name und Version, das Betriebssystem, die Bildschirmgröße mit ihrem Pixelverhältnis und die Größe des Viewports. Browser melden heute weniger über sich selbst als früher, sodass einige dieser Informationen unbekannt bleiben können, und jedes Feld ist bearbeitbar statt gesperrt.
Nichts wird aus den Pixeln abgeleitet. Das Tool versucht nicht, Fehlertext vom Bildschirm abzulesen oder zu erraten, welches Element Sie geklickt haben, denn dies unzuverlässig zu tun, ist schlimmer, als es nicht zu tun.
Die Struktur, die es ausfüllt
Die Ausgabe folgt der Form, auf die sich ein Fehlerbericht geeinigt hat, da Tracker und die Personen, die sie lesen, dies erwarten. Wenn Sie nach einer Vorlage für einen Fehlerbericht gesucht haben, ist dies eine, die bereits ausgefüllt ankommt, anstatt eine, die Sie einfügen und anstarren müssen.
Zuerst die Zusammenfassung, in einer einzigen Zeile, denn diese Zeile ist das, was jemand in einer Liste von dreißig Problemen scannt, und sie entscheidet, ob Ihr Problem heute geöffnet wird.
Dann nummerierte Schritte mit dem Zeitcode für jeden, erwartetes Verhalten, tatsächliches Verhalten und die Umgebung. Diese Reihenfolge ist keine Dekoration. Ein Leser prüft die Schritte, um zu sehen, ob es reproduzierbar ist, das erwartete und tatsächliche Paar, um zu sehen, ob es wirklich ein Fehler ist, und die Umgebung, um zu sehen, ob es deren ist. Das Vergraben einer dieser Informationen führt zu unnötigen Rückfragen.
Was eine leere Vorlage nicht kann, ist, sich selbst auszufüllen, was der Teil ist, der dazu führt, dass Leute sie überspringen. Hier kommen die Schritte, Zeitcodes, Frames und die Umgebung ausgefüllt an, und Sie schreiben die drei Felder, die ein Tool wirklich nicht wissen kann.
Vor der Aufnahme
Der Bericht ist nur so gut wie die Aufnahme, und zwei Gewohnheiten machen den Unterschied.
Beginnen Sie in einem bekannten Zustand. Eine Aufnahme, die mitten in einer Sitzung beginnt, lässt den Leser raten, was vorher geschah, sodass die Schritte nicht mehr reproduzierbar sind. Beginnen Sie auf einem Anmeldebildschirm, einer neuen Seite oder einem beschriebenen Ausgangspunkt.
Bereinigen Sie den Bildschirm von allem, was nicht mitgesendet werden soll. Tokens in einer URL-Leiste, der Name eines Kunden, eine irrelevante E-Mail in einem anderen Tab, ein API-Schlüssel in einem Entwickler-Panel. Ein Fehlerbericht wird weitergeleitet, in einen Chat eingefügt und von Personen außerhalb des Teams gelesen, und eine Bildschirmaufnahme enthält alles, was zum Zeitpunkt der Aufnahme auf dem Bildschirm war. Dieses Tool lädt das Video niemals hoch, aber der Bericht und die Frames gehen dorthin, wo Sie sie senden.
Was es nicht tut
Es reicht das Problem nicht ein. Es gibt keine Verbindung zu GitHub, Jira oder sonstigem; Sie kopieren den Bericht und fügen ihn dort ein, wo er hingehört, was auch bedeutet, dass Sie ihn lesen können, bevor es jemand anderes tut.
Es erfasst keine Logs, Netzwerkanfragen oder Konsolenausgaben. Diese befinden sich in Ihren Entwicklertools und sind für einige Fehler enorm wichtig. Fügen Sie diese über den sicheren Weg an, den Ihr Team bereits verwendet, anstatt eine Konsole zu filmen.
Und es diagnostiziert nichts. Es wird Ihnen nicht die Ursache nennen, welche Komponente fehlerhaft ist oder ob dies ein bestehendes Problem dupliziert. Es bringt die Beweise in eine Form, mit der jemand arbeiten kann, und das ist die ganze Aufgabe.
Den Fehler überhaupt erst aufzeichnen
Wenn Sie das Problem noch erfassen müssen, zeichnet der Bildschirmrekorder einen Tab, ein Fenster oder die gesamte Anzeige im Browser auf. Für einen Fehler, den Sie während der Reproduktion kommentieren müssen, nehmen Sie mit Audio auf, und die Erklärung bleibt an den Beweisen haften.
Zwei nützliche Nachbarn. Wenn Sie einzelne Bilder statt eines Berichts wünschen, extrahiert der Video-Frame-Extraktor Frames in Intervallen. Und wenn die Aufnahme lang ist und Sie die gesprochene Anleitung als Text wünschen, wandelt der Transkript-Generator die Erzählung in etwas Durchsuchbares um.
