Kako organizirati rezultate zadatka u izvješće?
Prvo odredite publiku i opseg dokaza, a zatim zahtijevajte jasnu strukturu.
Razjasnite za koga je izvješće namijenjeno
Sadržaj izvješća treba biti organiziran oko čitatelja i njegove svrhe. Prilikom pregleda za sebe, možete zadržati više detalja o procesu; kada je za programere, naglasite uvjete reprodukcije i tragove za ispravke; kada je za ne-tehničke čitatelje, počnite objašnjavanjem utjecaja. Prilikom zahtijevanja organizacije, navedite koji se potvrđeni materijali trebaju koristiti, ciljnu duljinu i koje informacije ne smiju biti u konačnoj verziji.
Osigurajte provjerljivu strukturu
Možete zahtijevati organizaciju prema pozadini, opsegu, metodama, zapažanjima, neprovjerenim stavkama i sljedećim koracima. Sigurnosni nalazi također trebaju biti povezani s odgovarajućim dokazima što je više moguće, umjesto samo pružanja oznaka rizika. Testni zapisi koji nisu pruženi trebaju biti označeni kao nedostajući i ne smiju se izmišljati samo radi dovršetka izvješća.
- Navedite zadatke i materijale obuhvaćene ovim izvješćem.
- Navedite publiku, format i dokaze koji trebaju biti zadržani.
- Zahtijevajte odvajanje provjerenih zaključaka i preporuka.
Provedite ručni pregled prije isporuke
Provjerite jesu li nazivi, datumi, opseg i reference točni te uklonite duplikate i nepotreban osjetljiv sadržaj. Ako su rezultati samo tijela poruka, možete ih kopirati i spremiti; samo kada se pojave stvarni datoteke za preuzimanje, trebate preuzeti putem unosa datoteke. Uredan format izvješća ne znači da su zaključci provjereni; neuspjesi alata, nepokriveni opsezi i proturječni zapisi jednako vrijede zadržati. Prije isporuke, također provjerite zadržava li konačni tekst potrebne uvjete i ograničenja.