diff options
Diffstat (limited to 'parnas-a-rational-design-process.rst')
-rw-r--r-- | parnas-a-rational-design-process.rst | 6 |
1 files changed, 3 insertions, 3 deletions
diff --git a/parnas-a-rational-design-process.rst b/parnas-a-rational-design-process.rst index 585cc87..974a65d 100644 --- a/parnas-a-rational-design-process.rst +++ b/parnas-a-rational-design-process.rst @@ -532,10 +532,10 @@ Page 18 (方梓安 翻, 欧阳芳 改) -VII. 现在, 我们如何假装理想的过程? +VII. 现在, 我们如何佯装理想的过程? `````````````````````````````````````````````````````````````````````````````` -上文描述了我们希望遵循的理想过程,以及在这过程中会产生的文档。 我们通过产生(如果我们用理想的方式做事会产生的)文档来假装这个过程。 我们试图用之前描述过的顺序去产生文档。 如果我们无法得到某部分信息,我们在文档相应位置注明,然后着手设计(犹如期望这部分信息将会改变)。 +上文描述了我们希望遵循的理想过程,以及在这过程中会产生的文档。 我们通过产生(假如我们用理想的方式做事会产生的)文档来佯装这个过程。 我们试图用之前描述过的顺序去产生文档。 如果我们无法得到某部分信息,我们在文档相应位置注明,然后着手设计(犹如期望这部分信息将会改变)。 如果我们发现错误,就会更改错误,并在后续文件中做相应的更改。 我们将文档作为设计的媒介,并且,在将设计决定加入文档获得所有层面的批准之前,我们不认为已经做出了任何设计决定。不管中途我们如何磕磕绊绊,最终的文档都会更容易理解并且准确。 我们不展示事情的实际发生过程,我们展示我们希望事情发生的过程,以及事情本身。 @@ -544,7 +544,7 @@ VII. 现在, 我们如何假装理想的过程? 我们相信类似的推理同样适用于软件。阅读软件文档的人们想要理解这个程序,而不是再现程序的发现过程。我们提供他们需要的合理化的文档。 -我们的文档在一个重要方面与理想化的文档不同。 我们制定一项政策,记录我们考虑过与拒绝的所有备选方案,包括在文档的早期版本中记录的决定。 对于每个备选方案,我们解释为什么它被考虑和为什么最后被拒绝。 几个月,几周,甚至几个小时后,当我们奇怪我们当初为什么那样做时,我们可以回去并找到原因。二十年后,维护者将有很多同样的问题,并将从我们的文档中找到他的答案。 +我们的文档在一个重要方面与理想化的文档不同。 我们制定一项政策,记录我们考虑过与拒绝过的所有备选方案,包括在文档的早期版本中记录的决定。 对于每个备选方案,我们解释为什么它被考虑和为什么最后被拒绝。 几个月,几周,甚至几个小时后,当我们奇怪我们当初为什么那样做时,我们可以回去并找到原因。二十年后,维护者将有很多同样的问题,并将从我们的文档中找到他的答案。 |