ISO/IEC IEEE 26512：软件工程 — 用户文档获取方和供应方的要求

ISO/IEC IEEE 26512解决了软件工程中一个关键但经常被忽视的方面：用户文档获取方和供应方之间的正式关系。在许多软件项目中，用户文档要么被假定包含在开发合同中而没有具体要求，要么从文档专家处单独采购。该标准为双方在采购和供应过程中定义、协商和验证文档交付物提供了一个结构化框架。

获取方责任与规范流程

标准定义了用户文档获取方的具体责任。获取方必须首先确定文档的业务需求，识别预期用户及其在操作环境中的信息需求。该分析构成文档规范的基础，文档规范是定义将交付哪些文档的关键合同文件。规范必须涵盖：每个文档交付物的范围和目的、目标受众特征和假设的先决知识、所需的内容主题和详细程度、输出格式和交付媒介要求、语言和本地化需求、质量标准和验收标准，以及进度和交付里程碑。

一个特别重要的要求是获取方必须指定一名合格的人员或团队来审查和接受文档交付物。该审查团队必须具有批准交付物的权力，并且必须包括代表实际最终用户视角的人员。获取方还有责任及时向供应方提供必要的主题专业知识和产品访问权限——文档不能在真空中产生，获取方未能提供充分的输入是文档质量问题的常见原因。

供应方责任与质量管理

在供应方方面，标准要求用户文档的供应方展示技术沟通的能力，并建立已定义的文档流程。供应方必须指定一名文档项目经理作为获取方的单一联系点，制定满足规定要求的文档计划，并实施质量保证程序，确保交付物在正式交付前符合商定的验收标准。

对供应方的质量管理要求包括：对照实际产品行为验证技术准确性，进行编辑审查以确保一致性和符合风格指南，在可行时使用代表用户测试文档可用性，以及为所有文档成果维护版本控制和配置管理。供应方还必须提供交付后处理变更请求和缺陷报告的机制，具有明确定义的升级路径和响应时间承诺。

合同考量与验收

验收过程是标准中最彻底定义的方面之一。验收标准必须是客观且可验证的——不是像”文档应易于使用”这样的主观陈述，而是可衡量的标准，如”文档应使经过培训的用户能够在Y分钟内完成任务X，且参考文档的次数不超过Z次。”标准提供了基于任务分析、用户特征和软件产品操作环境制定这些标准的指导。

标准还解决了初始交付后文档维护的关键问题。合同应明确供应方是否负责更新文档以反映软件变更、请求和授权更新的流程、维护服务的定价模式，以及在合同期结束时将文档责任转移给获取方或第三方的过渡计划。提前定义这些元素可以防止由于未明确分配维护责任而导致文档迅速过时的常见情况。

常见问题