在 Mon, 25 Jul 2011 17:31:07 +0800，Haiyan Lin <[email protected]> 写道:
《Perl Best
Practice》从如何写出便于自己维护、别人理解的代码的角度，给了很多很好的建议。不论是对骑小骆驼的娃儿，还是骑大骆驼的经验老手，都是一本不错的书，值得阅读一下。
非常感谢您的总结。我手边也PBP的影印书，还没好好看。
在 Mon, 25 Jul 2011 17:31:07 +0800，Haiyan Lin <[email protected]> 写道:
看了部分PBP，感觉是对于TMTOWTDI过分的纠正。很多时候，人们在感叹Perl的语
法自由的时候，其它人就会祭出Perl的教条。
最近写Javascript的时候，偶尔用了一下 TomDoc， 特别受用。特此分享一些心得：
http://tomdoc.org/
所以如果你是工程��，多�x�x�e人的程式�a，是很重要的，就跟�W����作一�印�
相反的，如果你的程式想要��人家�x懂，那 documentation
是非常重要的。GitHub 工程�� Zach Holman
�l表了一篇非常棒的文章，����解��了�槭颤N你要��文件，怎�N��。
http://zachholman.com/posts/documentation/
Documentation 是��人的 ―
相信我，你以後一定��回�砀倪@些程式，如果要��未�淼淖约焊�快�M入���r，把事情搞定，今天��你�毡匕��|西��清楚。
Documentation 是清楚的 ―
如果你不把你推出去的程式�a�v清楚，那根本是在�妥约赫衣���，以後一定��出�F一堆
bugs、困惑的同事，最後搞得自己更累而已。
Documentation 是可以�y��的 ―
因�槟惚仨�要把程式的����解��清楚，�@��你重新思考自己的��出�淼��|西是不是符合原始精神，有�]有更好的方式。�榱瞬辉���文件�r陷入�o法解��的�y�P，�@也迫使你��化每一��功能，把一���}�s的�|西切成好����功能。
Documentation 是可以比�^版本的 ―
好的文件可以��版本�g的比�^更容易，也���F��合作更有效率。
Documentation 是行�N ―
透�^好的文件，可以��下�d你���w的人更容易�_始使用，�@也大大提升了�D�Q率。
摘自：
http://mrjamie.cc/2011/06/09/code-documentation-fluency/?utm_source=feedburner&utm_medium=feed&utm_campaign=Feed%3A+MrJamie+%28Mr.+Jamie+%E7%9C%8B%E7%B6%B2%E8%B7%AF%E8%88%87%E5%89%B5%E6%8A%95%29
--
Hu Songtao
works as an English Teacher in weekends
Skype: idisblueflash
Beijing, China
--
您收到此邮件是因为您订阅了 Google 网上论坛的“PerlChina Mongers 讨论组”论坛。
要向此网上论坛发帖，请发送电子邮件至 [email protected]。
要取消订阅此网上论坛，请发送电子邮件至 [email protected]。
若有更多问题，请通过 http://groups.google.com/group/perlchina?hl=zh-CN 访问此网上论坛。
