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