summaryrefslogtreecommitdiff
path: root/parnas-a-rational-design-process.rst
diff options
context:
space:
mode:
Diffstat (limited to 'parnas-a-rational-design-process.rst')
-rw-r--r--parnas-a-rational-design-process.rst6
1 files changed, 1 insertions, 5 deletions
diff --git a/parnas-a-rational-design-process.rst b/parnas-a-rational-design-process.rst
index 7b0949d..f64a825 100644
--- a/parnas-a-rational-design-process.rst
+++ b/parnas-a-rational-design-process.rst
@@ -472,11 +472,7 @@ vii. 如何假装理想的过程?
我们相信此种类比同样适用于软件。 阅读软件文档是为理解这个程序,而不是
再现程序产生过程。 我们提供读者需要的合理化的文档。
-我们的文档在一个重要的方面不同于理想化的文档。我们制造了一个记录我们所
-有采纳和排除的所有备选方案,包括记录在文档早期版本中的决定。对于每一个
-问题,我们都解释了为什么它被采纳,为什么它最终被排除。几个月,几个星期,
-甚至几个20年后,此软件的维护者将有许多相同的问题,他将在我们的文件中找
-到答案。
+我们的文档在一个重要的方面与理想化的文档不同。 我们 **记录所有我们考虑过与排除的备选方案** , 包括记录文档的早期版本的决定。 对于每个备选方案,我们解释为什么当初会考虑它或为什么会最后排除它。 这样不管多长时间以后,我们(或维护者)有同样的问题就能从这些记录中找到答案。