Gør en løst supportsag brugbar for den næste kollega
En supportsag kan være afsluttet for kunden og stadig være dårligt dokumenteret for teamet. Et kort erfaringskort gør det lettere for den næste kollega at genkende problemet og forstå, hvornår løsningen er relevant.
Vælg en konkret, afsluttet sag
Rockwell-casen om søgbar teknikerviden giver inspiration til at strukturere erfaringer. Denne guide er min anbefaling til dokumentation af en ufarlig softwaresag; den er ikke en instruktion i reparation af maskiner.
Skriv observationen uden at gætte på årsagen
Notér hvad brugeren forsøgte at gøre, den synlige fejl og den relevante version eller opsætning. Skeln mellem det observerede symptom og den årsag, teamet senere fandt. Et upræcist udtryk som systemet virker ikke hjælper sjældent med genfinding.
Et tænkt eksempel er en CSV-import, hvor bestemte rækker afvises. Beskriv hvilke rækker og hvilken fejltype der var tale om, uden at kopiere kundens personoplysninger ind i erfaringskortet.
Registrér handlingen og dens begrænsning
Skriv den ændring, som blev foretaget, og hvad der ikke blev ændret, når det er nødvendigt for at forstå forløbet. Angiv eventuelle forudsætninger, eksempelvis et bestemt kolonneformat. En løsning bør ikke fremstå universel, hvis den kun er afprøvet i én situation.
Hold mislykkede forsøg adskilt fra den bekræftede løsning. Ellers kan en senere læser vælge det første beskrevne trin og overse, at det ikke løste problemet.
Vis hvordan resultatet blev kontrolleret
Notér den kontrol, der viste, at opgaven igen kunne gennemføres. I importeksemplet kan det være, at de tidligere afviste testrækker blev læst korrekt. En grøn besked i et system er ikke altid tilstrækkelig, hvis resultatet skal bruges et andet sted.
Tilføj dato og ansvarlig, så næste kollega ved, hvem der kan afklare spørgsmål. Markér usikre årsagsforklaringer som usikre, selv om selve problemet er løst.
Afprøv kortet som opslagsværk
Lad en kollega finde og forklare løsningen ud fra en kort problemtekst. Ret uklare ord og manglende forudsætninger. Når kortet kan stå på egne ben, er det et bedre grundlag for både almindelig søgning og en senere AI-assistent. Genbrugelig viden begynder med en forklaring, som mennesker faktisk kan efterprøve.