summaryrefslogtreecommitdiff
path: root/parnas-a-rational-design-process.rst
diff options
context:
space:
mode:
authorHui Lan <lanhui@zjnu.edu.cn>2021-07-24 16:33:41 +0800
committerHui Lan <lanhui@zjnu.edu.cn>2021-07-24 16:33:41 +0800
commitc7cb7cb26a7ad5b355dde1c848a2a6e7726a1834 (patch)
tree5fac2b2d374dc0e0b29827f096c61df556743818 /parnas-a-rational-design-process.rst
parent536bb1f8a39bb7c25d6ddfbaf168b2e84cd0a6c6 (diff)
parnas-a-rational-design-process.rst: 融入欧阳芳的翻译 (PDF page 18). Revision 1.
Diffstat (limited to 'parnas-a-rational-design-process.rst')
-rw-r--r--parnas-a-rational-design-process.rst21
1 files changed, 6 insertions, 15 deletions
diff --git a/parnas-a-rational-design-process.rst b/parnas-a-rational-design-process.rst
index 339ae5f..3ec4e59 100644
--- a/parnas-a-rational-design-process.rst
+++ b/parnas-a-rational-design-process.rst
@@ -585,25 +585,16 @@ Page 18
VII. 现在, 我们如何假装理想的过程?
``````````````````````````````````````````````````````````````````````````````
-上文描述了我们希望遵循的理想过程,以及在这过程中会产生的文档。 我们通过
-产生(如果我们用理想的方式做事会产生的)文档来假装这个过程。 我们试图用之前描述过的顺序去产生文档。 如
-果我们无法得到某部分信息,我们在文档相应位置注明,然后着手设计(犹如期望这部分信息将会改变)。
-如果我们发现错误,就会更改错误,并更改后续文件的错误。 我们将文档作为设计的媒介,并且,在将设计决定纳入
-文档获得所有层面的批准之前,不认为已经做出了任何设计决定。不管中途我们如何磕磕绊绊,最终的文档都会更容易理解并且准确。
-我们不展示事情的实际发生过程,我们展示我们希望它们发生的过程,以及事情本身。
+上文描述了我们希望遵循的理想过程,以及在这过程中会产生的文档。 我们通过产生(如果我们用理想的方式做事会产生的)文档来假装这个过程。 我们试图用之前描述过的顺序去产生文档。 如果我们无法得到某部分信息,我们在文档相应位置注明,然后着手设计(犹如期望这部分信息将会改变)。
+如果我们发现错误,就会更改错误,并更改后续文件的错误。 我们将文档作为设计的媒介,并且,在将设计决定纳入文档获得所有层面的批准之前,我们不认为已经做出了任何设计决定。不管中途我们如何磕磕绊绊,最终的文档都会更容易理解并且准确。
+我们不展示事情的实际发生过程,我们展示我们希望事情发生的过程,以及事情本身。
-即使是数学,许多人认为最理性的学科,也遵循上述过程。数学家勤勉地润色他
-们的证明,通常展示一个与他们最初发现的证明很不一样的证明。初始证明通常是痛苦
-的发现过程的结果。当数学家们致力于证明时,理解加深,证明简化。最
-终, 某一数学家找到了一个更简单的证明,使定理的真理性更明显。更简单的证明出版了,因为读者对定理的真理性感兴趣,而非发现的过程。
+即使是数学,许多人认为最理性的学科,也遵循上述过程。数学家们勤勉地润色他们的证明,通常展示一个与他们最初发现的证明很不一样的证明。第一个证明通常是痛苦的发现过程的结果。当数学家们致力于证明时,理解加深,证明简化。最终,某一位数学家找到了一个更简单的证明,使定理的真理性更明显。更简单的证明出版了,因为读者对定理的真理性感兴趣,而非发现的过程。
-我们相信类似推理同样适用于软件。阅读软件文档的人们想要理解这个程序,而不是
-再现程序的发现过程。我们提供他们需要的合理化的文档。
+我们相信类似的推理同样适用于软件。阅读软件文档的人们想要理解这个程序,而不是再现程序的发现过程。我们提供他们需要的合理化的文档。
-我们的文档在一个重要方面与理想化的文档不同。 我们制定**记录所有我们考虑
-过与拒绝的备选方案**的政策,包括在文档的早期版本中记录的决定。 对于每个备选方
-案,我们解释为什么它被考虑并且为什么最后被拒绝。 几个月,几周,甚至几个小时后,当我们奇怪我们当初为什么那样做时,我们可以回去并找到原因。二十年后,维护者会有很多同样的问题,并会从我们的文档中找到他的答案。
+我们的文档在一个重要方面与理想化的文档不同。 我们制定 **记录所有我们考虑过与拒绝的备选方案** 的政策,包括在文档的早期版本中记录的决定。 对于每个备选方案,我们解释为什么它被考虑并且为什么最后被拒绝。 几个月,几周,甚至几个小时后,当我们奇怪我们当初为什么那样做时,我们可以回去并找到原因。二十年后,维护者将有很多同样的问题,并将从我们的文档中找到他的答案。