佛法有云，诸法无性，尽随心转。文言便是，啥事都不要定性，太早下结论简单被打脸。要知道，心境变了，观点也就不相同了，比方婚前女友的叮嘱你只当心爱，到了婚后，老婆的叮嘱便成了聒噪。其实，咱也欠好骂这男人不念情义，相见时难别亦难，春风无力百花残。当时过境迁，年月糟蹋了美女，就算咱情比金坚，柔情款款也早变成了柴米油盐。昨日难再回，往日不行追，已然地球无法停转，咱们又何须守株待兔！
1
听说，程序猿平生最烦两件事，一则是他人要求他给自己编的代码写文档，二则是他人留下的代码没有留下文档。
他人要求自己写文档这事吧，码农们大可傲娇地想：“我写的代码阅览性这么好，居然还要求老子写文档，多此一举，生命好名贵，不行再糟蹋的好欠好！”，而关于他人的代码没留文档这档子事呢，码农们却很是能够借此大发怨言，“悲了个催的，写完代码，趁着热乎劲随手写点文档又不耽搁多大功夫，利人利己嘛！关键是这天杀的代码写得这么不流畅难明，还好意思不留文档，真是不负责任之极也，xx**&&***!” 。
都是大哥不说二哥，但聪明“绝了顶”的码农们莫非认识不到，这是光秃秃的五十步笑百步，典型的搞双重标准吗？莫非其智商忽然被溢出的心情仓库清了零吗？非也非也，在洒家看来，同行们一贯智商拔尖，在写文档的作业上如此严于待人，宽于律己，真实是由于大多数人都喜爱写代码、厌烦写文档的原因。何至于此，且听洒家娓娓道来。
2
还记得科比和清晨四点的洛杉矶的故事吗？
当年，一位傻白甜记者压抑着心里激荡不已的崇拜，问起横扫篮坛的科比：“你为什么能如此成功呢？”科比挺着被自傲充胀起来的鼓囊囊的胸肌，反问道：“你知道洛杉矶清晨四点钟是什么姿态吗？”记者微微一笑，识相地摇摇头：“不知道，什么样儿？”科比挠犯难，说：“满天星星，冷清的灯火，行人很少。”叨咕半天后，科比就像在念广告语相同，咬文嚼字地说道，“十多年过去了，洛杉矶大街早上四点的漆黑依然没有改动，但我却已变成了肌肉健旺，有体能、有力气，有着很高投篮命中率的运动员。”然后，科比咧开嘴笑了起来，白白的牙齿，黑黑的脸庞，让他的笑脸显得分外绚烂。
采访完毕后的这天夜里，记者顶着由于常常熬夜赶稿而发黑的眼圈，喝着提神的苦咖啡，再一次站在窗台前，望着清晨四点笼罩在一片漆黑之中的洛杉矶，苦苦思索着一个考虑了许多遍但总是茫无头绪的问题：“头顶同一片天，脚踩同一方地，为什么科比络绎在清晨四点的洛杉矶，日复一日，十多年来乐此不彼，总算成果了当下的自己，而我却只想草草地写完稿子，早早地回家睡觉？”一念至此，他又想起了我国喜剧演员范伟在小品《卖拐》里的一句经典台词：“同样是人，距离怎样就那么大尼！”
夜，益发地深重了，洛杉矶的清晨反常幽静，如同罩着一层轻纱，被偶然驶过的一辆轿车震颤一下，再度康复安静。和风悄悄吹动记者头顶那日渐稀疏的头发，送来一句弱不行闻的答案：“坚持早上，科比能年入数千万美金，而你却只能挣点不幸的稿酬！！稿酬。。。”
明月如钩，将冷冷的月光洒在记者瘦弱的脸庞上，他落寞地站立窗台，像老牛反刍相同细心咂摸着这句答案，一时间，竟不能自制，听凭风起如刀，吹落汩汩涌出到因多日繁忙未及修剪的胡须中的热泪，滴入依然冒着热气的廉价咖啡中。
相比之下，收入比记者更为悲催的程序员呢？睡得比妓晚，起得比鸡早，只因娃娃要上各种辅导班，婆娘们要过美好生活，便只能强撑着加快老化的残躯，拿着菲薄的收入，带着听诊器写代码，设身处地，咱们又怎样狠心苛责码农们为什么不写文档呢？行文至此，四大不空的洒家居然哀痛得不能自制，唉，唉，竟不知说啥好了。
在许多码农眼中，写文档，不写文档，工资标准就在那里，不高也不低。
3
全国熙熙，皆为利来，全国往往，皆为利往。做为万物之灵的人类一贯是无利不起早，当然会自觉地挑选利益最大化的作业方式。
码农的作业便是写代码，让体系正常稳定地跑起来，已然写文档形似不能多赚钱，谁不期望过着晃晃悠悠、又是一周的日子呢？干嘛自我加压，背上个写文档的苦差事？
可是假如，写文档不只有优点，并且优点大大滴呢？
经过写文档表达规划思维、总结作业中的经验教训之类的陈词滥调，洒家天然不屑再言，也无需多言。洒家想在这儿共享给我们的，是在多年边写代码边写文档的职业生涯中体会到的名副其实的优点，细细说来，大致有三。
4
一则协助快速修正代码。
都说一波三折，好代码也如是，需求重复屡次打磨。听说在佛门中证了初果、得了道共戒的修行者“初果犁地，虫离四寸”，犁地时，天然而然地不会碰到田地中的虫子，也就不会犯杀戒。天才码农改代码时也差不多是这种境地，改起来行云流水，指哪打哪，天然而然地不会由于改了一处代码而影响了其它的当地。
可是，程序员集体中更多的是像洒家这样的平庸之辈，改代码时挂一漏万，相互牵连。常常是拆了东墙，倒了西墙，改了代码后，信心百倍地以为不会带来其它影响，但屡次被无情的现实打脸。倘若有平常写代码时留下的文档，清楚地写明晰模块之间的相关，这样的过错就会削减许多，作业更轻松不说，也保全了脸面不是？
