Hvordan organiserer jeg oppgaveresultater i en rapport?
Avklar først målgruppen og dokumentasjonsgrunnlaget, og be deretter om en tydelig struktur.
Avklar hvem rapporten er for
Rapportinnholdet bør organiseres etter leserne og formålet. Ved egen gjennomgang kan du beholde flere prosessdetaljer. For utviklere bør du vektlegge betingelser for å gjenskape problemet og spor som kan hjelpe ved retting. For ikke-tekniske lesere bør du begynne med konsekvensene. Når du ber om organisering, oppgi hvilket bekreftet materiale som skal brukes, ønsket lengde og hvilken informasjon som ikke skal være med i sluttversjonen.
Gi en struktur som kan etterprøves
Du kan be om delene bakgrunn, omfang, metoder, observasjoner, uverifiserte punkter og neste steg. Sikkerhetsfunn bør så langt det er mulig knyttes til tilhørende dokumentasjon, i stedet for bare å få risikomerker. Testlogger som ikke er oppgitt, skal merkes som manglende og må ikke diktes opp for å gjøre rapporten komplett.
- Oppgi hvilke oppgaver og hvilket materiale rapporten dekker.
- Angi målgruppe, format og dokumentasjon som må beholdes.
- Be om et skille mellom verifiserte konklusjoner og anbefalinger.
Gjør en manuell gjennomgang før levering
Kontroller at navn, datoer, omfang og henvisninger er riktige, og fjern gjentakelser og unødvendig sensitivt innhold. Hvis resultatet bare er meldingstekst, kan du kopiere og lagre det. Bruk filnedlasting først når faktiske nedlastbare filer vises. En ryddig rapport betyr ikke at konklusjonene er verifisert. Verktøyfeil, områder som ikke er dekket, og motstridende oppføringer er også verdt å bevare. Kontroller før levering at sluttteksten fortsatt inneholder nødvendige betingelser og begrensninger.