summaryrefslogtreecommitdiff
path: root/parnas-a-rational-design-process.rst
diff options
context:
space:
mode:
Diffstat (limited to 'parnas-a-rational-design-process.rst')
-rw-r--r--parnas-a-rational-design-process.rst37
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