让别人读懂你的代码

[xhacker]

原先一直是自己写东西。

最近加入了一些开源项目。
自己的一些所谓的“项目”也有了别人接手。

别人的代码对我来说总是恐怖的。
相信我的代码对别人来说也是恐怖的。

……
所以，
能让别人读懂你的代码，
估计是最高境界了。

[no2x]

注释 是必须也是很重要的。开发文档，最好有文件简介。

[darcy]

的确，要想代码写得优雅不是一朝一夕的事情

[FRHong]

http://liuming.javaeye.com/blog/776890

You might be interested in this :)

[ratazzi]

现在觉得命名非常的重要，好的命名基本上不需要什么注释，主要是针对 PHP 来说，比如 Magento 的代码比起那些 vanilla 好读很多。

[Sam]

想起那个搞笑的注释：
只有上帝和我看得懂。
现在，只有上帝看得懂了。


刚学编程的时候写的代码，从不注释，过了几天，自己都看不懂了。

[lik]

编程就是和机器以及人类交流（项目合作者、几天后的自己）啊。

[cellsea]

为什么我从来都看得懂自己的代码呢？ 我从来不写注释的。。。 是我写的代码太简单了吧？？。。。