原书出处
程序员修炼之道:通向务实的最高境界(第2版)
7 交流!
编码的务实原则全部用于文档。 提示13
把文档嵌进去,而不要栓在表面 用源码中的注释生成好看的文档非常容易,建议给模块和导出函数都加上注释,这能在其他开发者使用的时候,给他们很大的助力。 不过,有人说必须给每个函数、数据结构、类型声明等都分别加上注释,我们并不
赞同这种做法。这种机械的注释方式实际上会
原书定位详情
来源:a19c7933-4eda-4176-aebd-30fe7e1ad292
正文位置:extracted/程序员修炼之道:通向务实的最高境界(第2版)/_epub-src/text/part0010_split_007.html
EPUB SHA-256:2e89a58cacd6cfea10ab5b234761cf67eba5ef28fadfbd4d30689830e980fdbb