Dokumentation når noget virker forkert

Written by

in

Problemet er allerede på bordet

Du har lige opdaget, at systemet spytter fejl ud som en defekt spillemaskine. Her er realiteten: uden præcis dokumentation bliver du aldrig i stand til at pege fingeren på den egentlige årsag. To sekunder er nok til at indse, at du sidder fast i en blindgyde.

Hvorfor du skal skrive ned hver eneste detalje

Først og fremmest er det ikke bare “noter hvad der skete”. Det er et krigslog, en kronik over hver klik, hver tidsstempel, hver serverrespons. Din chef vil ikke høre en sløret forklaring – han vil have beviser, som en advokat i en retssal. Så gør det nu.

Trin for trin – ingen undtagelser

Start med at tage et screenshot af fejlkoden. Sådan, der viser den røde advarsel i øjenhøjde. Dernæst, kopier den præcise API-request, inklusiv header-felter. Gem også netværkstrafikken i en .har-fil. Det er ikke “nice to have”, det er “must have”.

Den guldgrube du overser

Loggene i databasen. De er som en minestryger, der kun eksploderer, når du ignorerer dem. Hent de seneste rækker, filtrer på tidsintervallet, og marker de unormale værdier. Din kollega vil takke dig, når du har afsløret den skjulte fejl.

Her er pointen: Hvis du ikke har en samlet PDF-pakke med alt ovenstående, så er du allerede bagud. Så saml, organiser, og gem i en mappe med dato og projekt-ID. Ingen undskyldninger.

Og så er der den lille, men kritiske detalje: Dokumentation når noget virker forkert. Brug den som en skabelon. Ingen flere gæt. Ingen flere “det virkede på min maskine”.

Handl nu. Tag din første skærmoptagelse i dag.