当你写报告时,你是作为什么人写的?
第一人称单数:我在 HP Power Manager 中发现了一个漏洞...
第一人称复数:我们在 HP Power Manager 中发现了一个漏洞......
第三人称单数,按名称:Bob 在 HP Power Manager 中发现了一个漏洞...
第三人称单数,一般:测试人员在 HP Power Manager 中发现了一个漏洞...
第三人称单数,攻击者:攻击者在 HP Power Manager 中发现了一个漏洞...
当你写报告时,你是作为什么人写的?
第一人称单数:我在 HP Power Manager 中发现了一个漏洞...
第一人称复数:我们在 HP Power Manager 中发现了一个漏洞......
第三人称单数,按名称:Bob 在 HP Power Manager 中发现了一个漏洞...
第三人称单数,一般:测试人员在 HP Power Manager 中发现了一个漏洞...
第三人称单数,攻击者:攻击者在 HP Power Manager 中发现了一个漏洞...
其他一些选项:
被动语态:发现 HP Power Manager 中的漏洞...
现在时:HP Power Manager 容易受到...
使用被动语态是最常见的(至少在英国)。如果可能,我更喜欢使用现在时,否则我更喜欢使用第一人称复数;写作感觉更个人化。但这是有争议的;很多人认为报告应该是正式的,而不是个人的。
通常,您会看到它们以第一人称复数形式写成,而第三人称单数形式则较少见。如果您作为个人而不是公司的一部分进行工作,您可能会使用第一人称单数。
这是我使用的格式。您所做的事情的主动语态,系统存在状态的被动语态。
报告开头: $tester(以下简称“我们”/“我”)测试了$Application ...
对于叙事风格:我们/我测试了 foobar,发现它很容易受到 baz 的影响。
对于一种发现风格: Foo 系统容易受到 bar 的影响。我们/我使用 Baz 验证了它。
如果要理解您的目标,您将使用最清楚地说明实际发生的情况的表格。
如果您执行了该操作并且从上下文中理解了代词,则“我发现”优于任何其他理解方式。缺少必要的上下文“保罗发现……”或“保罗伯克兰发现……”是最清楚的。
这里有一些答案围绕着典型的概念或避免让读者感到难过。但是,如果交流的目的是交流,请同情您的读者,并优先考虑清晰性。
他们必须阅读,这是一门如此困难的艺术,以至于大多数人即使在小学和高中之后也无法真正掌握它——长达十二年。
所以这个讨论最终必须承认,作为作家,我们的风格选择既不丰富也不迷人,因为我们的读者注定是这样不完美的艺术家。
— Kurt Vonnegut, Jr.“如何用风格写作” IEEE Transactions on Professional Communications Vol。PC-24 No. 2 (1981) DOI: 10.1109/TPC.1981.6447837