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