En tant que personne, dois-je rédiger un rapport de test de pénétration?
Lorsque vous rédigez un rapport, sous quelle personne le rédigez-vous?
Première personne du singulier: J'ai découvert une vulnérabilité dans HP Power Manager ...
Première personne du pluriel: Nous avons découvert une vulnérabilité dans HP Power Manager ...
Troisième personne du singulier, par son nom: Bob a découvert une vulnérabilité dans HP Power Manager ...
Troisième personne du singulier, général: Le testeur a découvert une vulnérabilité dans HP Power Manager ...
Troisième personne du singulier, attaquant: L'attaquant a découvert une vulnérabilité dans HP Power Manager ...
Quelques autres options:
Voix passive: Une vulnérabilité dans HP Power Manager a été découverte ...
Présent: HP Power Manager est vulnérable à ...
Il est plus courant (du moins au Royaume-Uni) d'utiliser la voix passive. Je préfère utiliser le présent lorsque cela est possible, et la première personne du pluriel dans le cas contraire; l'écriture semble plus personnelle. Mais cela est controversé; beaucoup de gens pensent que les rapports sont censés être formels et pas du tout personnels.
Généralement, vous les verrez écrits à la première personne du pluriel et moins souvent à la troisième personne du singulier, général. Vous pourriez faire la première personne du singulier si vous effectuez le travail en tant qu'individu et non dans le cadre d'une entreprise.
Voici le format que j'ai utilisé. Voix active pour ce que vous avez fait, voix passive pour l'état dans lequel le système existe.
Au début du rapport: $ testeur (dorénavant dénommé "nous"/"I") testé $ Application ...
Pour un style narratif: Nous avons/j'ai testé le foobar et nous l'avons trouvé vulnérable au baz.
Pour un style de résultats: Le système Foo est vulnérable à la barre. Nous l'avons/j'ai vérifié en utilisant Baz.
Si votre objectif est d'être compris, vous utiliserez les formulaires qui indiquent le plus clairement ce qui s'est réellement passé.
Si vous avez exécuté l'action et que le pronom est compris dans son contexte, "j'ai découvert" est supérieur à toute alternative de compréhension. Le contexte nécessaire absent "Paul a découvert ..." ou "Paul Burkeland a découvert ..." est très clair.
Il y a des réponses ici qui dansent autour des concepts de ce qui est typique ou évitent de faire que le lecteur se sente mal. Mais si le but de la communication est de communiquer, ayez pitié de votre lecteur et privilégiez la clarté avant tout.
Ils doivent lire lire , un art si difficile que la plupart des gens ne le maîtrisent pas vraiment même après l'école primaire et secondaire - douze longues années.
Donc, cette discussion doit enfin reconnaître que nos options stylistiques en tant qu'écrivains ne sont ni nombreuses ni glamour, car nos lecteurs sont nécessairement des artistes imparfaits.
- Kurt Vonnegut, Jr. "Comment écrire avec style" Transactions IEEE sur les communications professionnelles Vol. PC-24 n ° 2 (1981) DOI: 10.1109/TPC.1981.6447837