阅读《构建执法》第四章及第十七章有感

阅读《构建执法》第四章及第十七章有感

第四章

原文：

   不需要注释程序是怎么工作的（How），注释是为了解释程序做什么（What），为什么这样做（Why），以及特别要注意的地方。

问题：

   书上说注释的核心是What和Why，不要注释How，但是当一个才学软件的人看注释就是为了看懂How，例如我在看C语言程序设计时，有些注释都详细解释了这段程序是如何工作的，那么我们是否也应该适当注释一些How呢？

看法：

   我上网百度了一下，下面是引用：

在每个例程的开始，提供标准的注释样本以指示例程的用途、假设和限制很有帮助。注释样本应该是解释它为什么存在和可以做什么的简短介绍

使用注释来解释代码的意图。它们不应作为代码的联机翻译

资料所说都是强调What和Why，而没有提到How，但是我个人觉得考虑到新手等情况，注释还是应该适当考虑How

 

第十七章

原文：

   原则1 公众

   软件工程师的行为应与公众利益一致

疑问：

   当一件事符合公众利益时它是否是道德的且和合法的？

看法：

   我觉得有时候公众利益不一定是符合道德的，举一个简单的例子，大概是去年国庆阅兵的时候，在所有人都在关注阅兵是，某一位明星在微博上晒出了自己孩子的照片，评论里一片谩骂之声，而那位明星也删了微博并且道歉了。这件事令我非常疑惑，这位明星你说她做错了什么呢？难道晒孩子照片不对吗？还是我们一定要看阅兵？好像没有吧，而有些人自以为站在道德制高点便开始职责甚至谩骂。看阅兵这件事是符合公众利益的，然后从道德层面上看，因为没有看阅兵而晒孩子照片遭到网络暴力，这件事符合我们的道德价值观吗？