Adskil intern undersøgelse og fælles status i en softwarefejl
Under en fejlundersøgelse har teamet brug for at drøfte mulige forklaringer. Den person, der rapporterede fejlen, har især brug for at vide, hvad der er bekræftet, hvad næste skridt er, og hvornår der kommer nyt.
1. Start med en fælles sagsidentitet
Brug samme sagsnummer eller reference i de relevante arbejdsspor. Notér den oprindelige handling og det forventede resultat, så undersøgelsen ikke gradvist kommer til at handle om en anden fejl.
GitHubs nye fortrolige kommentarer til sikkerhedssager er en anledning til denne guide. Metoden nedenfor er en generel redaktionel anbefaling til samarbejde om softwarefejl.
- GitHub: Confidential advisory comments Publiceret
2. Skriv observation og hypotese hver for sig
En observation kan være, at en bestemt handling gav en fejl i en bestemt opsætning. En hypotese er den forklaring, teamet vil undersøge. Markér forskellen direkte i teksten.
Tilføj, hvilket forsøg der kan be- eller afkræfte forklaringen, hvem der udfører det, og hvilket resultat der ændrer næste handling. Et internt notat bør hjælpe arbejdet videre.
3. Vælg modtagere før notatet gemmes
Kontrollér den konkrete målgruppe for den kanal eller kommentartype, der bruges. Skriv kun de oplysninger, der er nødvendige for denne del af undersøgelsen.
En etiket med ordet intern er ikke tilstrækkelig dokumentation for adgang. Brug systemets faktiske rettigheder og virksomhedens gældende praksis som grundlag for placeringen.
4. Formulér den fælles status selvstændigt
Skriv, hvad teamet har bekræftet, hvilken afklaring der mangler, og hvornår næste opdatering forventes. Angiv tydeligt, hvis der endnu ikke er en kendt løsning eller en verificeret midlertidig vej.
Kopiér ikke bare hele den interne diskussion. En selvstændig status kan være kort og præcis uden at gøre uafprøvede forklaringer til fastslåede årsager.
5. Luk efter den oprindelige fejl er kontrolleret
Når en rettelse foreligger, gentag den relevante oprindelige handling i et passende testmiljø. Skriv, hvilken version der er kontrolleret, og hvilke begrænsninger der stadig gælder.
En overdragelse til en anden kollega eller en nærliggende rettelse er ikke nok til at lukke sagen. Bevar én ansvarlig, som samler resultatet og den afsluttende status.