A quale persona dovrei scrivere un rapporto sui test di penetrazione come?

39

Quando scrivi un rapporto, a quale persona lo scrivi?

Prima persona singolare : ho scoperto una vulnerabilità in HP Power Manager ...

Prima persona plurale : abbiamo scoperto una vulnerabilità in HP Power Manager ...

Terza persona singolare, per nome : Bob ha scoperto una vulnerabilità in HP Power Manager ...

Terza persona singolare, generale : il tester ha scoperto una vulnerabilità in HP Power Manager ...

Terza persona singolare, attaccante : l'autore dell'attacco ha scoperto una vulnerabilità in HP Power Manager ...

    
posta nyxgeek 27.01.2016 - 01:06
fonte

4 risposte

49

Alcune altre opzioni:

Voce passiva : scoperta di una vulnerabilità in HP Power Manager ...

Tempo presente : HP Power Manager è vulnerabile a ...

È più comune (almeno nel Regno Unito) usare la voce passiva. Preferisco usare il tempo presente quando possibile, e prima persona plurale altrimenti; la scrittura sembra più personale. Ma questo è controverso; molte persone pensano che i rapporti dovrebbero essere formali e per niente personali.

    
risposta data 27.01.2016 - 06:12
fonte
20

In genere li vedrai scritti in prima persona plurale, e meno spesso in terza persona singolare, generale. Potresti fare in prima persona singolare se conduci il lavoro come individuo e non come parte di un'azienda.

    
risposta data 27.01.2016 - 01:17
fonte
5

Ecco il formato che ho usato. Voce attiva per le cose che hai fatto, voce passiva per lo stato in cui il sistema esiste.

All'inizio del rapporto: $ tester (d'ora in poi chiamato "noi" / "I") ha testato $ Applicazione ...

Per uno stile narrativo: abbiamo / testato il foobar e ho scoperto che era vulnerabile a baz.

Per uno stile di risultati: il sistema Foo è vulnerabile alla barra. Lo abbiamo verificato con Baz.

    
risposta data 27.01.2016 - 19:39
fonte
4

Se il tuo obiettivo deve essere compreso, utilizzerai i moduli che dicono più chiaramente cosa sia realmente accaduto.

Se hai eseguito l'azione e il pronome è compreso dal contesto, "ho scoperto" è superiore a qualsiasi alternativa per la comprensione. Assente contesto necessario "Paul ha scoperto ..." o "Paul Burkeland ha scoperto ..." è molto chiaro.

Qui ci sono risposte che danzano intorno ai concetti di ciò che è tipico o evitano di far star male il lettore. Ma se lo scopo della comunicazione è comunicare, pietà del tuo lettore e preferisci soprattutto la chiarezza.

They have to read, an art so difficult that most people don't really master it even after grade school and high school – twelve long years.

So this discussion must finally acknowledge that our stylistic options as writers are neither numerous nor glamorous, since our readers are bound to be such imperfect artists.

— Kurt Vonnegut, Jr. "How to write with style" IEEE Transactions on Professional Communications Vol. PC-24 No. 2 (1981) DOI: 10.1109/TPC.1981.6447837

    
risposta data 27.01.2016 - 14:30
fonte

Leggi altre domande sui tag