原书出处
编写可读代码的艺术
总结 总结 注释的目的是
帮助读者了解作者在写代码时已经知道的那些事情。本章介绍了如何发现所有的并不那么明显的信息块并且把它们写下来。 什么地方不需要注释: ·能从代码本身中迅速地推断的事实。 ·用来粉饰烂代码(例如蹩脚的函数名)的“拐杖式注释”——应该把代码改好。 你应该记录下来的想法包括:
·对于为什么代码写成这样而不是那样的内在
原书定位详情
来源:a19c7933-4eda-4176-aebd-30fe7e1ad292
正文位置:extracted/OReilly精品图书系列共21册(《Javascript权威指南》、《机器学习:实用案例解析》、《编写可读代码的艺术》、《算法精解》等)/_epub-src/text/part2728.html
EPUB SHA-256:06582ecdf071724c9e218bc2698d2fff4e82a992d672b287e4c2e6092c924bcf