原书出处
编写可读代码的艺术
: ·对于为什么代码写成这样而不是那样的
内在理由(“指导性批注”)。 ·代码中的缺陷,使用像TODO:或者XXX:这样的标记。 ·常量背后的故事,为什么是这个值。 站在读者的立场上思考: ·预料到代码中哪些部分会让读者说:“啊?”并且给它们加上注释。 ·为普通读者意料之外的行为加上注释。 ·在文件/类的级别上
使用“全局观”注释来解释所有的部分是如何
原书定位详情
来源:a19c7933-4eda-4176-aebd-30fe7e1ad292
正文位置:extracted/OReilly精品图书系列共21册(《Javascript权威指南》、《机器学习:实用案例解析》、《编写可读代码的艺术》、《算法精解》等)/_epub-src/text/part2728.html
EPUB SHA-256:06582ecdf071724c9e218bc2698d2fff4e82a992d672b287e4c2e6092c924bcf