diff options
Diffstat (limited to 'parnas-a-rational-design-process.rst')
| -rw-r--r-- | parnas-a-rational-design-process.rst | 2 |
1 files changed, 1 insertions, 1 deletions
diff --git a/parnas-a-rational-design-process.rst b/parnas-a-rational-design-process.rst index 4bcea1e..c6aeacf 100644 --- a/parnas-a-rational-design-process.rst +++ b/parnas-a-rational-design-process.rst @@ -546,7 +546,7 @@ VII. 现在， 我们如何假装理想的过程？ 我们相信类似的推理同样适用于软件。阅读软件文档的人们想要理解这个程序，而不是再现程序的发现过程。我们提供他们需要的合理化的文档。 -我们的文档在一个重要方面与理想化的文档不同。 我们制定 **记录所有我们考虑过与拒绝的备选方案** 的政策，包括在文档的早期版本中记录的决定。 对于每个备选方案，我们解释为什么它被考虑和为什么最后被拒绝。 几个月，几周，甚至几个小时后，当我们奇怪我们当初为什么那样做时，我们可以回去并找到原因。二十年后，维护者将有很多同样的问题，并将从我们的文档中找到他的答案。 +我们的文档在一个重要方面与理想化的文档不同。 我们制定一项政策，记录我们考虑过与拒绝的所有备选方案，包括在文档的早期版本中记录的决定。 对于每个备选方案，我们解释为什么它被考虑和为什么最后被拒绝。 几个月，几周，甚至几个小时后，当我们奇怪我们当初为什么那样做时，我们可以回去并找到原因。二十年后，维护者将有很多同样的问题，并将从我们的文档中找到他的答案。 |