
1.8 陷阱描述
第2章给出了对不同陷阱的概要的描述,而第3章记录了每个测试陷阱的详细信息,如下:
·标题 该陷阱的简短、描述性名称
·描述 该陷阱的简单定义
·可能出现之处 陷阱可能出现的环境
·典型症状 (或者,你怎么知道)表明可能存在的陷阱的症状
·潜在的负面后果 (为何你要关心)如果不避免或减轻陷阱,预期潜在的负面后果[3]
·潜在原因 陷阱潜在的根本原因和近因[4]
·建议 (你应该做什么)建议采取的行动(准备、启用、执行和验证)来避免或减轻陷阱[5]
·相关的陷阱 其他相关测试陷阱列表
在开始阅读单个陷阱之前,这里有关于选词和语法的几句话:
·可能出现之处 你可能在你的项目中落入这些陷阱,也可能不会。有些陷阱更可能出现,因此,这些陷阱比其他陷阱更相关。当然,如果你已经掉进一个既定的陷阱,它就不再是可能出现的,而是一定会出现。因为目前存在可能出现之处,将用现在时进行描述。
·典型症状 你可能已经在过去观察到这些症状,你很可能现在正在观察它们。它们甚至有可能在未来等着你。不必写出所有三种时态拯救了我,更重要的是,不必阅读它们也拯救了你,我用现在时列出了所有的症状。
·潜在的负面后果 再次,你可能已经在过去遭受过这些后果,也可能正在发生。这些后果可能仍然在未来出现,如果你现在遵循合适的建议则可避免(或减缓)。这些后果用现在时列出。
·请注意,有时一个陷阱的第一症状是因为你陷入而遭受的负面后果。因此,是否应该列入症状、后果或两者并不总是显而易见。为了避免将同一负面事件或情况在同一个陷阱里列出两次,我尽力在最明显的标题下包含一次。
·潜在原因 最后,原因也可能在你的过去、现在或将来。然而,它们似乎最好用过去时态写,因为从本质上,它们必须先于陷阱的症状和后果。
[1] 这些时态是针对英文原文而言的,在中文中未体现。——编辑注