diff options
-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 4405606..1f8d224 100644 --- a/parnas-a-rational-design-process.rst +++ b/parnas-a-rational-design-process.rst @@ -414,7 +414,7 @@ Page 14 F. 编写程序 ```````````````````````````````````````````````````````````````````````````````` -完成所有这些设计和文档之后,我们就已经准备好编写实际的可执行代码了。我们发现编写过程快速而流畅。我们认为,代码注释不应该包含文档中已经写有的内容。这是不必要的,这会使维护系统更加昂贵,同时增加了代码与文档不一致的可能性。 +完成所有这些设计和文档之后,我们就已经准备好编写实际的可执行代码了。我们发现编写过程快速而流畅。我们认为,代码注释不应该包含文档中已经写有的冗余内容。这是不必要的,这会使维护系统更加昂贵,同时增加了代码与文档不一致的可能性。 (因为会出现代码注释改了,而忘了更新对应位置的文档。或者文档改了,而忘了更新对应位置的代码注释。-- 译者注) |