summaryrefslogtreecommitdiff
path: root/parnas-a-rational-design-process.rst
diff options
context:
space:
mode:
authorHui Lan <lanhui@zjnu.edu.cn>2019-07-29 19:24:30 +0800
committerHui Lan <lanhui@zjnu.edu.cn>2019-07-29 19:24:30 +0800
commit45ce961dfa80cfb449d5154f313bdb2865dbd7d6 (patch)
treed66999b4fe901d8741c9077c6898481bd5046f1a /parnas-a-rational-design-process.rst
parentdfa06e861825902464bf22e7a3da133bcdcc0200 (diff)
parnas-a-rational-design-process.rst: 阅读并修改周佳威的翻译
Diffstat (limited to 'parnas-a-rational-design-process.rst')
-rw-r--r--parnas-a-rational-design-process.rst38
1 files changed, 15 insertions, 23 deletions
diff --git a/parnas-a-rational-design-process.rst b/parnas-a-rational-design-process.rst
index 18c9227..2aae647 100644
--- a/parnas-a-rational-design-process.rst
+++ b/parnas-a-rational-design-process.rst
@@ -486,36 +486,28 @@ execution)”, 我们花大力气来设计每个文件的结构。 通过声
-Page 17.a - 周佳威
+Page 17 - 周佳威 OK
--------------------------------------------------------------------------------
-这样生成的文档既不简单也不轻松,但也不枯燥。我们利用表格、公式和形式符
-号来增加信息的密度。我们的组织规则防止了信息重复,其结果是文档化,必须
-非常认真地阅读,但回报读者详细和准确的信息。为了避免传统文档中出现混淆
-和不一致的术语,我们使用了特殊括号和类型化字典系统。我们必须定义的许多
-术语中的每一个都包含在一对显示其类型的括号符号中。对于每个这样的类型,
-我们都有一个只包含该类型定义的字典。虽然刚开始阅读的读者会发现!+terms+l、
-%terms%、#terms#等符号的存在,但是令人不安的是,像我们这样文档的普通用
-户会发现括号中隐含的类型信息使文档更容易阅读。使用由类型构成的字典使我
-们不太可能为同一个概念定义两个术语,或者为同一个术语赋予两个含义,同时
-特殊的括号符号使对已介绍但未定义或已定义但从未使用过的术语进行机械检查
-变得很容易。现在,我们如何伪造理想过程?
-
-上面描述了我们希望遵循的理想流程以及在此流程中生成的文档。我们通过生成
-文档来伪造这个过程,如果我们以理想的方式做事,就会生成这些文档。我们试
-图按我们所描述的顺序制作这些文件。如果我们不能得到一条信息,我们就会注
-意到在文档的一部分中,信息应该去哪里并继续设计,就好像该信息会按照预期
-发生变化一样。如果发现错误,我们将更改它们,并在随后的文档中进行相应的
-更正。我们将文档作为设计的媒介,在所有级别的设计决策都被批准纳入文档之
-前,不会考虑任何设计决策。无论我们在途中遇到多少困难,最终的文档都将更
-容易理解和适应。我们没有展示事情实际发生的方式,我们展示的是我们希望事
-情发生的方式和事情的方式。
+这样生成的文档读起来不容易、不轻松,但也不枯燥。 我们用表格、公式和正式符号来增加信息密度。 我们文档结构规则避免了信息重复。 这样的文档必须聚精会神地读, 但是会回馈给读者以详细准确的信息。
+
+为避免传统文档遍布着混淆的与不一致的术语的情况, 我们用一种由特殊括号与类型字典组成的术语系统。 每个必须定义的术语都被嵌在一对括号符号中, 括号符号反应了术语的类型。 对每个类型,我们有一个字典, 字典包含了对该类型的定义。 虽然刚开始阅读我们文档的读者会觉得 !+terms+!、 %terms%、 #terms# 这些符号干扰了阅读, 但是经常读我们文档的用户会觉得这些特殊括号隐含的类型信息反而会使阅读变容易。 类型字典减少了我们为同一个概念定义两个术语, 或者为同一个术语给出两个定义的可能。 特殊括号对已经引入但但未定义, 或已定义但从未使用过的术语进行机械检查变得容易。
+
+.. 上面描述了我们希望遵循的理想流程以及在此流程中生成的文档。我们通过生成
+ 文档来伪造这个过程,如果我们以理想的方式做事,就会生成这些文档。我们试
+ 图按我们所描述的顺序制作这些文件。如果我们不能得到一条信息,我们就会注
+ 意到在文档的一部分中,信息应该去哪里并继续设计,就好像该信息会按照预期
+ 发生变化一样。如果发现错误,我们将更改它们,并在随后的文档中进行相应的
+ 更正。我们将文档作为设计的媒介,在所有级别的设计决策都被批准纳入文档之
+ 前,不会考虑任何设计决策。无论我们在途中遇到多少困难,最终的文档都将更
+ 容易理解和适应。我们没有展示事情实际发生的方式,我们展示的是我们希望事
+ 情发生的方式和事情的方式。 (见下文方子安处)
Page 18 - 方梓安 OK
-----------------------------------------------------------------------------------
-vii. 如何假装理想的过程?
+vii. 现在, 如何假装理想的过程?
上文描述了我们希望遵循的理想过程,以及这一过程所产生的文档。 我们通过
产生文档来假装这个过程。 我们用上文描述的顺序去试着产生一系列文件。 如