diff options
author | Hui Lan <lanhui@zjnu.edu.cn> | 2021-07-25 15:58:32 +0800 |
---|---|---|
committer | Hui Lan <lanhui@zjnu.edu.cn> | 2021-07-25 15:58:32 +0800 |
commit | cbb8f00302eb3460afa5be27aab9fa9f96a527fc (patch) | |
tree | 3a8eb8f687432d691bfde8b3ab1250f37d7c3a4d | |
parent | d4dcfa822d7aadbbf939f66d6550dcaf395543f9 (diff) |
parnas-a-rational-design-process.rst: 隐去陈俊蕾的翻译,因为前面已经有了陈肖飞的翻译了。
-rw-r--r-- | parnas-a-rational-design-process.rst | 37 |
1 files changed, 19 insertions, 18 deletions
diff --git a/parnas-a-rational-design-process.rst b/parnas-a-rational-design-process.rst index ee461d0..cf66ba6 100644 --- a/parnas-a-rational-design-process.rst +++ b/parnas-a-rational-design-process.rst @@ -451,32 +451,33 @@ A. 当前的文档有什么问题? 为什么它难用? 为什么没有人 -Page 15 ----------------------------------------------------------------------------- +.. + Page 15 + ---------------------------------------------------------------------------- -(陈俊蕾 翻) + (陈俊蕾 翻) -文档中多余的注解是没必要的,且会使系统维护变得更加昂贵。 除此之外,还 -会增加代码与原文档不符的可能性。 + 文档中多余的注解是没必要的,且会使系统维护变得更加昂贵。 除此之外,还 + 会增加代码与原文档不符的可能性。 -VI. 文件在此过程中充当什么样的角色? -`````````````````````````````````````````````````````````````````````````````` + VI. 文件在此过程中充当什么样的角色? + `````````````````````````````````````````````````````````````````````````````` -现在的文档到底哪儿有问题? 为何难用? 为何没人读? + 现在的文档到底哪儿有问题? 为何难用? 为何没人读? -显然,设计过程中文档扮演着一个重要的角色。是祸躲不过,许多程序员认为文 -档是“事后考虑”之物,只是官僚的要求而作。我们认为那些在发表前从未被使用 -的文档都是很差的文档。 + 显然,设计过程中文档扮演着一个重要的角色。是祸躲不过,许多程序员认为文 + 档是“事后考虑”之物,只是官僚的要求而作。我们认为那些在发表前从未被使用 + 的文档都是很差的文档。 -大多数文档都不完整、不精确,但这不是主要问题。可以通过添加或修改信息进 -行改正。 事实上是引起文档不完整与不正确的内在结构组织问题不容易修复。 + 大多数文档都不完整、不精确,但这不是主要问题。可以通过添加或修改信息进 + 行改正。 事实上是引起文档不完整与不正确的内在结构组织问题不容易修复。 -- 很差的文档组织结构。 现今的文档,可分为 **意识流** 与 **执行流** 。 - 意识流写作把即兴想法写在作者正在写的地方。执行流写作按照系统运行时事 - 件发生的顺序去写。 这两种文档风格的问题是:除作者本人,其他人不容易 - 找到他们想要的信息。 因此难以判定某信息是否丢失,难以修改错误信息。 - 软件发生变化时,找不到所有文档对应的位置去修改。 + - 很差的文档组织结构。 现今的文档,可分为 **意识流** 与 **执行流** 。 + 意识流写作把即兴想法写在作者正在写的地方。执行流写作按照系统运行时事 + 件发生的顺序去写。 这两种文档风格的问题是:除作者本人,其他人不容易 + 找到他们想要的信息。 因此难以判定某信息是否丢失,难以修改错误信息。 + 软件发生变化时,找不到所有文档对应的位置去修改。 Page 15 |