文档测试是软件评测师上午场考试中每年必考的知识点，软件产品由可运行的程序、数据和文档组成，所以文档是软件的一个重要组成部分。在软件的整个生命周期中，会用到许多文档，在各个阶段中以文档作为前阶段工作成果的体现和后阶段工作的依据。下面就文档的分类、内容、测试要点等知识点进行总结学习。
一、文档的分类：
（1）开发文档：软件的开发过程中，软件开发人员需根据工作计划和需求说明书由粗而细地进行设计，这些需求说明书和设计说明书构成了开发文档。例如软件需求说明书、数据库设计说明书、概要设计说明书、详细设计说明书和可行性研究报告等。
（2）用户文档：为了使用户了解软件的使用、操作和对软件进行维护，软件开发人员需要为用户提供详细的资料，这些资料称为用户文档。例如用户手册、操作手册和维护修改建议等。
（3）管理文档：为了使管理人员及整个软件开发项目组了解软件开发项目安排、进度、资源使用和成果等，还需要制定和编写一些工作计划或工作报告，这些计划和报告构成了管理文档。例如项目开发计划、测试计划、测试报告、开发进度月报和开发总结报告等。
二、用户文档的内容：随着技术的进步和市场的规范，用户文档的范围越来越大了。以下这些都可以算是用户文档，并不是每一个软件都必须具有所有这些文档，但大多不出此列。
（1）包装上的文字和图案
（2）宣传材料、广告及其他插页
（3）授权/注册登记表
（4）最终用户许可协议
（5）标签和不干胶条
（6）安装和设置指导
（7）用户手册
（8）联机帮助
（9）指南、向导
（10）样例、示例和模板
（11）错误提示信息
三、用户文档的优点：对待用户文档要像对待程序一样给予同等关注和投入，因为对于用户来说，文档和程序同样重要。
（1）改善易安装性
（2）提高软件的易用性
（3）改善软件的可靠性
（4）促进销路：高质量的文档常会被作为卖点，可以帮助销售人员说明和推荐产品。
（5）降低技术支持的费用
四、用户文档测试需要注意的地方：
（1）读者群：文档面向的读者定位要明确。不能一个文档面向所有级别的读者，文档的目的是要让用户看得懂，能理解，但不可以写成散文、诗歌或者侦探、言情小说等。
（2）术语：文档中用到的术语要适用于定位的读者群，用法一致，标准定义与业界规范相吻合。
（3）正确性：测试中需检查所有信息是否真实正确。
（4）完整性：对照软件界面检查是否有重要的分支没有描述到，甚至是否有整个大模块没有描述到，耐心补充遗漏的步骤。对于极其熟悉被测软件的人来说，这项测试相当困难，因为思路已固定地按照一定的流程去测试，极易忽略不常用的部分。因此，可以考虑让不是很熟悉被测软件的人员进行此项目的测试。
（5）一致性：按照文档描述的操作执行后，检查软件返回的结果是否与文档描述相同。
（6）易用性：纸介质文档可以通过目录、关键词索引提高用户使用的易用性，电子文档或帮助系统显然比纸介质在这方面有更大的优势。需要注意的是，文档要有助于用户排除错误，只描述正确操作而不描述错误处理办法的文档是不负责任的。与程序大多用于错误处理一样，文档对于用户看到的错误信息应当有更详细的文档解释，而且不应让用户花费太多的时间去寻找所需的解释。
（7）图表与界面截图：检查所有图表与界面截图是否与发行版本相同。
（8）样例和示例：像用户一样载入和使用样例，用每一个模板来制作文件，确认它们的正确性。
（9）语言：对于英语文档来说，可以使用拼写和语法检查器。对于中文文档可以采用一些校对工具辅助人工检查，并进行细致专业的校对，不要让用户发现错别字，不要出现有二义性的说法。特别要注意的是屏幕截图或绘制图形中的文字，不能想当然，没有任何工具能够从图形中找出语法错误。
（10）印刷与包装：对于纸质版的用户文档，测试人员需抽查印刷质量，看看手册厚度与开本是否合适，翻看起来是否方便，包装盒的大小是否合适，光盘盒的固定有没有问题，有没有零碎易丢失的小部件等。对于在线帮助文档则不涉及印刷与包装的测试。
五、对用户手册的测试操作：
（1）准确地按照手册的描述使用程序：检查计算机对错误的处理和手册对错误处理的描述应当占用测试人员的大部分精力。
（2）尝试每一条建议。
（3）检查每条陈述：测试人员需要对每条陈述进行检查，因为用户手册是产品最终的规范，是用户检查程序运行是否正确首先求证的地方。
（4）查找容易误导用户的内容。
六、对在线帮助文档的测试：帮助文档的测试在很大程度上与用户手册测试相同，但帮助文档并不只是用户手册的电子版，因此再给出以下几点补充说明。
（1）准确性：对帮助文档准确性检查的细致程度至少要接近于对用户手册的检查。一旦用户发现帮助中存在明显的错误，他可能对帮助系统的信任程度大大下降。
（2）帮助是文档编写和程序编写的结合：不仅要检查文本的准确性，还要检查程序的可靠性。
（3）帮助索引：如果帮助系统包含了索引或主题列表，允许用户由索引进入到主题中，测试人员就必须逐条进行检查。
（4）超链接：超链接是在线帮助中必须的功能。测试人员必须对每个链接都测试到，复杂的超链接可能会对一个主题形成树状结构展开的若干页面，甚至构成网状结构，测试人员有义务检查每条分支。
（5）链接的意义：索引和链接的条目应当是有意义的，测试人员需要发现是否有一些帮助主题未出现在索引里，或出现的名称不恰当。如果用户不能迅速找到所需的信息，只能说帮助系统在一程度上是失败的。
（6）帮助的风格：很少会有用户能悠闲地查看帮助，帮助的阅读者是带着问题、焦躁不安而缺乏耐心的。帮助文档需要比用户手册更为简洁，风格也应更为简单。良好的帮助系统应该是面向任务或面向操作的，它必须提供一些有意义的信息，让用户能立即开始或继续他的操作。任何在帮助中出现的令人迷惑或离题的内容都可以作为测试问题。
下面是近几年对文档测试考察过的真题，近几年基本上都是在上午题的第66小题出现，并且每次考试基本上都是1道题目，以后仍是考试出题的重点，大家要重视起来。
【2017年53题】以下不属于文档测试的测试范围的是（ ）
A、软件开发计划
B、数据库脚本
C、测试分析报告
D、用户手册
解析：本题考查文档测试的测试范围。
AC属于管理文档，D属于用户文档，数据库脚本不属于文档测试的范围。
故正确答案为：B
【2018年66题】以下关于文档测试的叙述中，不正确的是( )。
A、文档要面向所有级别读者
B、文档中用到的术语要符合行业规范
C、需要检查所有信息是否真实正确
D、需要检查软件返回结果跟文档描述是否一致
解析：本题考查文档测试的基础知识。
文档面向读者应该定位要明确，不能一个文档面向所有级别。
故正确答案为：A
【2019年66题】在线帮助测试属于文档测试的一项，以下（ ）不属于在线帮助文档测试的测试内容。
A、印刷与包装
B、准确性
C、帮助索引
D、超链接
解析：本题考查文档测试的基础知识。
既然是在线帮助测试，则不涉及到线下印刷和包装方面的工作。
正确答案为：A
作者唯一官方个人微信公众号（昊洋与你一起成长）：HYJY20180101
写于2021年8月5日
作者：昊洋讲师
版权所有，侵权必究
