《the mythical Man-Month》:Pass the word 产品经理写的文档就是依托答辩

概要：此文依然是喷产品负责人的理论性引用。主要是关于如何写需求文档。

Chapter 6. 贯彻执行 / 传递消息 Passing the Word

他只是坐在那里，嘴里说："做这个！做那个！"当然，什么都不会发生，光说不做是没有用的。- 哈里·杜鲁门，关于总统的权力1 He'll sit here and he'll say, "Do this! Do that!" And nothing will happen. - HARRY S. TRUMAN, ON PRESIDENTIAL POWER1

如何保证工作、系统概念完整性的有效执行？

文档化的规格说明—手册

• 文档是非常必要的，它描述和规定了用户所见的每一个细节，也是结构师主要的工作产物。
• 架构师须为功能准备一种实现方法，但不应该试图去支配具体的实现过程。
• 架构师可多，但文档编写人员宜少，这样能保持文字和产品之间的一致性。

comment：实际开发中产品从来不会提供相关的流程图，用例图，而这需要我自己去总结画出并且传递。

虽然敏捷在推崇文档轻量化，但是文档的第一要求是 “可执行性”，而不是描述性！

在软件开发中，文档的可执行性指的是文档的内容是否能够被直接执行或实施。具体来说，可执行性意味着文档中所描述的步骤、指导或规范是否能够被开发人员或系统直接操作和应用。

一个具有可执行性的文档应该具备以下特点：

清晰明确：文档中的指导和说明应该清晰、准确，能够被读者理解和操作。
可操作性：文档中的步骤和操作应该能够被开发人员或系统按照文档的要求进行实施。
实用性：文档中的内容应该与实际开发过程相符合，能够解决实际问题。
通过具备可执行性的文档，开发团队可以更好地理解和实施软件开发过程中的各项任务和要求，提高开发效率，减少错误和风险。因此，在软件开发中，编写具有可执行性的文档是非常重要的一环。

文档语言应该具有“形式化定义”（属于meta-language）

形式化定义是一种精确而明确的方式来描述概念、对象或现象。它使用形式化语言和符号系统来规定定义，以便消除歧义和模糊性。形式化定义通常用于数学、逻辑、计算机科学等领域。

以下是一些形式化定义的例子：

自然数的形式化定义：自然数是一个集合，满足以下条件：
a) 0 是自然数的一部分。
b) 如果 n 是自然数的一部分，那么 n 的后继（即 n+1）也是自然数的一部分。

二叉树的形式化定义：二叉树是一个有限集合，满足以下条件：
a) 如果树为空，则它是一个二叉树。
b) 如果树不为空，那么它由一个根节点和两个子树组成，这两个子树也都是二叉树。

布尔代数的形式化定义：布尔代数是一个包含两个元素（真和假）和三种运算符（与、或、非）的代数系统，满足一定的运算规则和公理。

记叙性文字可以显示结构性的原则

这句话的意思是，记叙性文字可以通过展示结构性原则来进行理解。也就是说，通过记叙性的文字描述，我们可以看到其中所蕴含的结构性原则或规律。

简单来说：sample / 用户场景 应该使用记叙性文字来描述

当我们阅读一篇记叙性的文字时，其中的描述和叙述方式往往会反映出一定的结构性原则。例如，作者可能会按照时间顺序、空间布局或因果关系来组织叙述，从而展示出事件或情节之间的结构性关系。

通过理解这些结构性原则，我们可以更好地把握整个叙述的逻辑和内在的组织方式。这有助于我们更深入地理解文本的含义和作者的意图，并能够更准确地解读其中所传达的信息。

因此，这句话的含义是指出，记叙性文字不仅仅是简单的叙述事件，而是通过展示结构性原则来帮助读者更好地理解和解读文本。

好的task描述包括：形式化 和 记叙性 两种描述方式