一，文档化活动

将需求活动中产生或得到的信息变成文本持久化保存的行动（记录与客户的面谈，记录讨论会得到的软件特性、优先级、决策等）
编写正规的需求文档（如愿景、用例文档、需求规格说明书、补充规格说明书）等
在需求工程中，文档化活动涉及文档化信息、文档化需求和需求规约。
文档化活动的意义
- 持久化。将各种信息持久化，以免遗失或遗忘
- 共同参照。通过记录有关信息并共享，让所有涉众都可以参照引用
- 促进交流。共同参照是交流的基础
- 提升客观性。通过文档交流信息比起口头交流更准确一致，不易随意更改。
- 支持新成员上手。团队引入新成员，借助各种文档快速掌握情况。
- 保存专家知识。文档化可以让专家的知识显性化，降低了对个别专家的依赖有助于反映问题。
- 记录信息的过程，让记录者可以发现相关信息的不一致或差距，进而做出反应
需求工程对文档化活动的研究主要涵盖：
- 文档的种类或分类。
- 文档的质量准则和验收准则
- 文档的结构和格式
- 文档化的形式与技术
一般质量准则——一个需求文档
- 完整的。没有遗漏任何与涉众相关的信息
- 可追踪的。来源、演化及在后续开发阶段的影响和使用是可追踪的
- 正确的。需求制品已经被涉众确认了，并要求系统必须完整地实现它
- 无歧义的。只允许一种合理的解释
- 可理解的。一般涉众容易理解内容表达
- 一致的。内容陈述不会自相矛盾
- 可验证的。涉众可以对所实现的系统是否满足需求文档的描述进行检查
- 已评级的。需求文档的相关性/稳定性已被确定并记录
- 最新的。需求制品反映了系统及上下文的当前状态
- 原子的。需求制品描述的是单一的、内聚的事实
验收准则： 对系统，或某一制品（软件，文档，数据，说明书等）的验收规则。
**文档形式： **需求工程中主要采用自然语言（图，数学表达式，编程语言是其他可能的形式）

二，愿景(如果只要一个文档，就是“愿景”)

愿景是我们要掌握的一种需求文档，该文档属于“目标”性文档
从需求的层次看，愿景文档中涵盖了属于问题域的**“需要”(Needs),以及属于解决方案领域的“特性”**(Features)。
愿景文档主要描述软件的高层需求
以一种简洁、抽象、可读和可管理的方式，从各种重要角度描述了产品的多个方面。
有利于内部涉众(营销、技术、管理)协商
愿景文档应该尽量简洁，不要太长

重点！！！

文档化活动：需求工程核心活动。
文档化活动包含的范围：所有形成文字记录的活动都是文档化活动。编写正式的需求规格说明，只是文档化活动的一部分，但是最重要部分
文档的种类、质量标准、验收标准、结构和格式、形式和技术等是文档化活动内涵
愿景： 最重要的需求文档。是目标性需求制品，描述软件的涉众、高层需求。包含了需求三角形中的“需要”(Needs)、“特性” (Features)两大部分。
愿景文档中包含了问题描述、涉众分析，是前期上下文分析的成果。