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.rst20
1 files changed, 11 insertions, 9 deletions
diff --git a/parnas-a-rational-design-process.rst b/parnas-a-rational-design-process.rst
index fa2ba4f..a95168b 100644
--- a/parnas-a-rational-design-process.rst
+++ b/parnas-a-rational-design-process.rst
@@ -388,27 +388,29 @@ Page 12
(何可人 翻)
-虽然,每人负责写一个文件, 但这些文件实际上是在模块实现者、模块使用者, 对模块设计感兴趣的人(如审稿人)商议过程中产生的。 这些规范文件的主要内容有:
+虽然每个这样的文档都有一个人负责, 但是这些文档实际上是在模块实现者、模块使用者以及其他对设计感兴趣的人(例如评审员)协商过程中产生的。这些规范文件的主要内容有:
-- 被访程序 (access program): 可被其它模块中的程序调用的程序列表。
+- 可被其他模块的程序调用的程序列表,(叫做被访程序 (access program));
-- 被访程序的参数。
+- 被访程序的参数;
-- 被访程序对彼此的影响。
+- 被访程序对彼此的作用;
-- 时间约束与精度约束 (如果需要)。
+- 时间约束与精度约束 (如果需要);
-- 意外事件 (undesired events) 的定义(禁止发生的事)
+- 意外事件 (undesired events) 的定义(禁止发生的事件);
-许多方面,模块规范类似需求文件。 但是,模块规范所使用的符号与文档结构更适合描述软件与软件的接口。 已发表的例子和解释有 [11],[2],[1],[5]。
+许多方面,该模块规范类似需求文件。 但是,模块规范所使用的符号与结构更适合这个阶段我们所关注的软件对软件的接口。
+
+已发表的例子和解释包括 [11],[2],[1],[5]。
D. 设计并记录模块内部结构
````````````````````````````````````````````````````````````````````````````````
-一旦指定了模块接口, 实现可以作为独立任务去执行。 但是,开始编码之前, 我们想在模块设计文档中记录主要的设计决策。 这个文档允许我们编码前对设计有效的评审, 并向未来的维护程序员解释代码背后的意图。
+一旦指定了模块接口, 除了评审外,它的实现可以作为独立任务去执行。 但是,开始编码之前, 我们想在模块设计文档中记录主要的设计决策。 这个文档的目的是允许编码前对设计有效的评审, 并向未来的维护程序员解释代码背后的意图。
-在某些情况下, 模块只是被简单地分成几个子模块, 设计文件是另一个模块指南。 在这种情况下,该模块的设计过程在上面的步骤 B_ 处继续。
+在某些情况下, 模块被简单地分成子模块, 子模块的设计文档是另一个模块指南,其设计过程在上文的B步骤继续。
Page 13