From 5dfbb1ab1d7dac1f8900e6035a65b37e274d7604 Mon Sep 17 00:00:00 2001 From: Hui Lan Date: Sun, 17 Jul 2022 15:50:04 +0800 Subject: =?UTF-8?q?parnas-a-rational-design-process.rst:=20=E8=9E=8D?= =?UTF-8?q?=E5=85=A5=E5=AD=99=E9=9B=AA=E6=B3=A2=E7=9A=84=E7=BF=BB=E8=AF=91?= =?UTF-8?q?=E6=94=B9=E8=BF=9B=E5=BB=BA=E8=AE=AE?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- parnas-a-rational-design-process.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'parnas-a-rational-design-process.rst') 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. 编写程序 ```````````````````````````````````````````````````````````````````````````````` -完成所有这些设计和文档之后，我们就已经准备好编写实际的可执行代码了。我们发现编写过程快速而流畅。我们认为，代码注释不应该包含文档中已经写有的内容。这是不必要的，这会使维护系统更加昂贵，同时增加了代码与文档不一致的可能性。 +完成所有这些设计和文档之后，我们就已经准备好编写实际的可执行代码了。我们发现编写过程快速而流畅。我们认为，代码注释不应该包含文档中已经写有的冗余内容。这是不必要的，这会使维护系统更加昂贵，同时增加了代码与文档不一致的可能性。 （因为会出现代码注释改了，而忘了更新对应位置的文档。或者文档改了，而忘了更新对应位置的代码注释。-- 译者注） -- cgit v1.2.1