软件设计的哲学：第二十章 为什么要写注释
目录 12.1 好代码是自我解释的 12.2 我没有时间写注释 12.3 注释会过时并产生误导 12.4 我所看到的一切注释都是毫无价值的 12.5 良好的注释的好处 代码内文档在软件设计中起着至关重要的作用。 注释对于帮助开发人员理解系统和有效地 ...
原文：软件设计的哲学： 第十五章 先写注释
目录 . 延迟的注释是糟糕的注释 . 先写注释 . 注释是一个设计工具 . 早期的注释很有趣 . 早期的注释代价高昂吗 . 结论 许多开发人员将编写文档的工作推迟到开发过程的末尾，即编码和单元测试完成之后。这是产生低质量文档的最可靠的方法之一。编写注释的最佳时间是在过程的开始，即编写代码的时候。 首先编写注释使文档成为设计过程的一部分。这不仅产生了更好的文档，而且还产生了更好的设计，并使编写文档 ...
2019-12-26 10:04 1 679 推荐指数：
相关推荐
软件设计的哲学： 第九章 合并还是分解
9.9 结论 软件设计中最基本的问题之一是：给定两部分功能，它们应该在同一个地方一起实 ...
软件设计的哲学 第五章 隐藏信息
结论 第四章论述了模块的深度。本章以及随后的几章将讨论创建深度模块的技术。 5.1 信息隐 ...
软件设计的哲学：前言
。所有这些讨论都是有价值的，但是软件设计的核心问题在很大程度上仍然没有触及。David Parnas的经典 ...
软件设计的哲学：第十三章 注释应该描述代码中隐藏的内容
目录 13.1 选择约定 13.2 不要重复代码 13.3 低级注释增加了精确性 13.4 更高层次的注释增强直觉 13.5 接口文档 13.6 建议：什么和为什么，而不是如何 13.7 跨模块设计决策 13.8 结论 13.9 对第13.5 ...
软件设计的哲学【翻译】--目录
2020年必读书籍推荐：软件设计的哲学（A Philosophy of Software Design），本书190多页，豆瓣的点评分在9分以上，目前只有英文版本，中文版还未上市，英文好的同学建议去直接阅读原版。 作者简介 John Ousterhout是斯坦福大学计算机科学教授。他目前 ...
2020荐书：软件设计的哲学
2020年必读书籍推荐：软件设计的哲学（A Philosophy of Software Design），本书190多页，豆瓣的点评分在9分以上，目前只有英文版本，中文版还未上市，英文好的同学建议去直接阅读原版。 内容简介 书中讨论了软件设计的主题：如何将复杂的软件 ...
软件设计的哲学： 第六章 更深的通用模块
目录 6.1 使类具有一定的通用性 6.2 示例：为编辑器存储文本 6.3更通用的API 6.4 通用性使得信息隐藏效果更好 6.5 问自己的问题 6.6 结论 在设计新模块时，最常见的一个决定就是以通用方式还是特殊方式实现它。有些人可能会 ...