关于“注释”的问题。并不是楼主要表达的意思，那是是编好程序的两个方面。

还是用个场景说明：

外出入住House，管理员会带你到各房间，厨房、盥洗室、卫生间看一下。同样，恐怕大多家里的厨房、厕所门口也不会贴一个牌子（注释一下）。为什么？因为功能分类了。即便没“注释”，外人一看就大体了解了。

但这并不代表内部具体器件的功能，你就了解。（例如：一般水龙头你会用；初次接触恒温水龙头，你就不一定会用。）这就需要“注释”说明，至少有人要告诉你正确的使用方法。（高压锅没放气就开盖，也听说过不少。嘿嘿。）

但是，一个社区的公共设施或规模大的家庭，就需要“注释”；（我一个国外亲戚家，厕所就标上有 Gents、Ladies）甚至还要标好“指引注释”，才好。

所以，楼主的意思是：好程序要有框架，分层、分类、做好通用模块化；并不是功能块的堆砌。

这样做，即便 “注释”丢了。人家也能看明白个“大概其”。

是吧？