阅读《构建执法》第四章及第十七章有感
阅读《构建执法》第四章及第十七章有感
第四章
原文:
不需要注释程序是怎么工作的(How),注释是为了解释程序做什么(What),为什么这样做(Why),以及特别要注意的地方。
问题:
书上说注释的核心是What和Why,不要注释How,但是当一个才学软件的人看注释就是为了看懂How,例如我在看C语言程序设计时,有些注释都详细解释了这段程序是如何工作的,那么我们是否也应该适当注释一些How呢?
看法:
我上网百度了一下,下面是引用:
在每个例程的开始,提供标准的注释样本以指示例程的用途、假设和限制很有帮助。注释样本应该是解释它为什么存在和可以做什么的简短介绍
使用注释来解释代码的意图。它们不应作为代码的联机翻译
资料所说都是强调What和Why,而没有提到How,但是我个人觉得考虑到新手等情况,注释还是应该适当考虑How
第十七章
原文:
原则1 公众
软件工程师的行为应与公众利益一致
疑问:
当一件事符合公众利益时它是否是道德的且和合法的?
看法:
我觉得有时候公众利益不一定是符合道德的,举一个简单的例子,大概是去年国庆阅兵的时候,在所有人都在关注阅兵是,某一位明星在微博上晒出了自己孩子的照片,评论里一片谩骂之声,而那位明星也删了微博并且道歉了。这件事令我非常疑惑,这位明星你说她做错了什么呢?难道晒孩子照片不对吗?还是我们一定要看阅兵?好像没有吧,而有些人自以为站在道德制高点便开始职责甚至谩骂。看阅兵这件事是符合公众利益的,然后从道德层面上看,因为没有看阅兵而晒孩子照片遭到网络暴力,这件事符合我们的道德价值观吗?