diff options
author | Hui Lan <lanhui@zjnu.edu.cn> | 2021-07-26 17:57:49 +0800 |
---|---|---|
committer | Hui Lan <lanhui@zjnu.edu.cn> | 2021-07-26 17:57:49 +0800 |
commit | 533631d4bed0609c9960ed38a77a364d759eda31 (patch) | |
tree | f7a7c0486b706a44da53c3a3127841e7786dce29 | |
parent | d4806652aea6ce6e8fd3ce99420719a2c5afbf65 (diff) |
parnas-a-rational-design-process.rst: 融入张俊玲的翻译 (PDF page 16). Revision 1.
-rw-r--r-- | parnas-a-rational-design-process.rst | 7 |
1 files changed, 3 insertions, 4 deletions
diff --git a/parnas-a-rational-design-process.rst b/parnas-a-rational-design-process.rst index 14e2d94..2b0f695 100644 --- a/parnas-a-rational-design-process.rst +++ b/parnas-a-rational-design-process.rst @@ -491,12 +491,11 @@ Page 16 B. 如何避免这些问题? -在理想设计过程中的文档既满足了开发人员需求, 也满足了后来的维护程序员的需求。上面提到的每个文件都记录了设计决策,并在余下的设计中被用作参考文件。然而,它们也提供了软件维护者将需要的信息。因为这些文件在整个软件构建过 -程中被用作参考手册,它们将是成熟的,并且在以后的工作中随时可用。 它们将总是最新的。 我们设计过程中的文档不是事后才做的; 它被视为项目的主要产品之一。 有一些检查可以被应用来增加其完整性和一致性。 +在理想设计过程中的文档既满足了开发人员需求, 也满足了后来的维护程序员的需求。上面提到的每个文件都记录了设计决策,并在其余的设计中被用作参考文件。然而,它们也提供了软件维护者将需要的信息。因为这些文件在整个软件构建过程中被用作参考手册,它们将是成熟的,并且在以后的工作中随时可用。 它们将总是最新的。 我们设计过程中的文档不是事后才写的; 它被视为项目的主要产品之一。 可以做一些检查来增加其完整性和一致性。 -这种产生文档的方法的主要优点之一是可以减轻 **人月神话效应 (The Mythical Man Month effect)** [4]。当新程序员加入项目时, 他们不需要依赖老员工来获得信息。他们将会有一个最新的且理性的文件集。 +这种产生文档的方法的主要优点之一是可以改善 **人月神话效应 (The Mythical Man Month effect)** [4]。当新程序员加入项目时, 他们不需要依赖老员工来获得信息。他们将会有一个最新的且理性的文件集。 -我们通过花大力气去设计每个文件的结构避免“意识流 (stream of consciousness)”和“执行流 (stream of execution)”。我们通过规定文件必须回答的问题来定义文件;我们将这一纪律贯彻至文件的所有小节。我们试图为每一个必须要包括的事实找一个位置,并且确保只有一个这样的位置。 只有在确定了文件结构之后,我们才开始写。如果我们要写一个特定类型的许多文件,我们就为这些文件写并且发布一个标准结构 [5]。 我们所有的文件都是按照与指导软件设计相同的原则来设计的,即关注点分离。系统的每个方面都只在一节中描述,且该节不描述其他内容。当我们的文件被审查时,我们会审查它们对文档规则的遵守以及准确性。 +我们通过花大力气去设计每个文件的结构避免“意识流 (stream of consciousness)”与“执行流 (stream of execution)”。我们通过规定文件必须回答的问题来定义文件;我们将这一纪律贯彻至文件的所有小节。我们试图为每一个必须要包括的事实找一个位置,并且确保只有一个这样的位置。 只有在确定了文件结构之后,我们才开始写。如果我们要写一个特定类型的许多文件,我们就为这些文件编写并且发布一个标准结构 [5]。 我们所有的文件都是按照与指导软件设计相同的原则来设计的,即关注点分离。系统的每个方面都只在一节中描述,且该节不描述其他内容。当我们的文件被审查时,我们会审查它们对文档规则的遵守情况以及准确性。 |