今天下午的乐高，讨论了代码规范中注释的部分。做为实用主义者，我们不喜欢过多的注释。“让代码的速度跟得上思考的速度”是我们一直提倡和追求的，也就是代码要写得入如注释般清晰，简洁，让人可以如读英文文章一样的读代码，而不是读注释。
我们干掉了所有PHPDoc才认识的东西，就是/** @param这样的东西，，另外注释统一了用两个斜杠(//)，而不用斜杠星号(/*…*/)，以强化就算有，也要短到一行的意思。
当我们强调注释或者文档的时候，或许是在解决错误的问题。越长的注释，就意味着越过期的注释。
我们反对过度文档，而尽量用最简洁的代码来取代它。与其在注释上花功夫，不如在函数和变量的命名上多推敲，花时间多做重构，把分层和封装做好，把抽象做好。
“没有比提高一个没有必要的事情的效率更没有效率的事情了。”一次一次在开发过程中被验证。
说到底，写代码如同写文章，有十几种不同的写法，无非在“推”和“敲”两个都不错的字中寻求最佳的那一个，或者在一个恶心的A和一个恶心的B之间徘徊，绞尽脑汁寻找一个不是那么恶心的C。说到底，没有绝对的对和错，只有合适与不合适。一群人，在一起磨合出来一种共同的思路，才是有力量的开发团队，否则只是乌合之众。
2010年9月的一次乐高日
后注：看看我们刚刚做好的一个页面
我相信函数更新历史等放在注释中会比放在svn中更直观一些。
是也乎，是也乎！
– 没有意义的注释比没有注释要邪恶!
– 有注释的烂代码也比烂代码要恶心!
– 没有注释的烂代码比烂代码更恶心!
代码的可读性比注释要靠谱,
用doctest代替注释要爽直!
但是,认真/真实/同步的注释,特别是有文档化输出的注释,真的是非常有价值的…
当然,如果我们的代码永远没可能被公司以外的人见到,那么注释就是练习输入了…
代码我不专业，审美我还可以
招聘页面的一点建议：
第一，沙滩合影色调需要处理一下，有些阴暗，需要给人光明前景的感觉。
第二，“雁阵”的后面增加几个空白的人型轮廓，加个箭头的指向，符字“这是你的位置”
有道理，好的代码是自明的，另外，我这里看不到图
哈哈，能不能贴一点不是核心的代码出来观赏一下
天气不错。最好的看到所有代码的方式是看一看jobs.baixing.com。
背景屏幕上好像显示的是Gooogle统计？哈
留个脚印。
这个/*…*/不错,表情丰富:)