主题：【原创】乱侃软件工程师的素养 1 -- poorfat

这个系列基本上写的都是我在工作中遇到的另我痛恨的事情。所以免不了我要骂人。这个贴继续开骂。

我曾经接手过一个测试文档，其中有一条测试案例是这样写的：（大意）

“ 请确认某某功能是好的。（verify function XYZ works.）”

诸位，如果你被分派去执行这条测试案例，你会不会骂人？我是涵养很好的人，所以我只是默默地在心里把文档作者骂了几遍。然后我虚心地向作者请教以下几个问题：

1 - 到底什么叫做“是好的”？ 你到底要我达到什么测试目的？

2 - 我应该执行什么步骤来测试该功能？

3 - 什么情况下我可以认定该项测试成功了？

4 - 什么情况下我可以认定该项测试失败了？（由于众所周知的原因，你最好保证3 和4是互斥的， 否则我还要继续踢你屁股）

5 - 如果测试失败了，我应该向谁举报？由谁负责订正错误？

以上都是一些最最基本的测试问题。这些问题不搞清楚，没有人可以执行测试的。写这个测试案例的人一定已经有丰富的执行该测试的经验了。所以他一看这些字眼就知道该怎么做。 可是其他人不一定是这方面的专家。 所以你如果想要其他同事能够顺利执行你写的测试案例，你最好花点功夫，把你的文档写清楚。不要假设人人都能看懂你写的文档。

一个完整的测试案例，不仅要有以上提到的几条，还至少要有以下几点：

- 执行该项测试的人员需要哪些预备知识？背景知识？

- 前期准备工作有哪些？

- 测试环境是什么？如何认定测试环境是有效的？如果测试环境不正确，那么你得到的测试结果就是无效的，无论是成功了，还是失败了。

- 需要哪些硬件电脑？

- 需要哪些软件工具？

总之写文档的时候，一定要把问题的来龙去脉都搞清楚了，别人才有可能看得懂。 记住，文档是要让别人看懂的， 不是用来卖弄你的水平的。