Re: [PerlChina] 闲聊

在 Mon, 25 Jul 2011 17:31:07 +0800，Haiyan Lin <linhy0120@gmail.com> 写道:

> 《Perl Best
> Practice》从如何写出便于自己维护、别人理解的代码的角度，给了很多很好的建议。不论是对骑小骆驼的娃儿，还是骑大骆驼的经验老手，都是一本不错的书，值得阅读一下。
>
非常感谢您的总结。我手边也PBP的影印书，还没好好看。

在 Mon, 25 Jul 2011 17:31:07 +0800，Haiyan Lin <linhy0120@gmail.com> 写道:

> 看了部分PBP，感觉是对于TMTOWTDI过分的纠正。很多时候，人们在感叹Perl的语
> 法自由的时候，其它人就会祭出Perl的教条。

最近写Javascript的时候，偶尔用了一下 TomDoc， 特别受用。特此分享一些心得：
http://tomdoc.org/

> 所以如果你是工程�，多���人的程式�，是很重要的，就跟���作一�。
> 相反的，如果你的程式想要�人家�懂，那 documentation
> 是非常重要的。GitHub 工程� Zach Holman
> �表了一篇非常棒的文章，��解�了�什�你要�文件，怎��。
http://zachholman.com/posts/documentation/

> Documentation 是�人的 ―
> 相信我，你以後一定�回�改�些程式，如果要�未�的自己更快�入��，把事情搞定，今天�你�必把�西�清楚。
> Documentation 是清楚的 ―
> 如果你不把你推出去的程式��清楚，那根本是在�自己找麻�，以後一定�出�一堆
> bugs、困惑的同事，最後搞得自己更累而已。
> Documentation 是可以��的 ―
> 因�你必�要把程式的��解�清楚，��你重新思考自己的�出�的�西是不是符合原始精神，有�有更好的方式。�了不在�文件�陷入�法解�的��，�也迫使你�化每一�功能，把一���的�西切成好��功能。
> Documentation 是可以比�版本的 ―
> 好的文件可以�版本�的比�更容易，也���合作更有效率。
> Documentation 是行� ―
> 透�好的文件，可以�下�你��的人更容易�始使用，�也大大提升了��率。
> 摘自：
> 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 讨论组"论坛。
要向此网上论坛发帖，请发送电子邮件至 perlchina@googlegroups.com。
要取消订阅此网上论坛，请发送电子邮件至 perlchina+unsubscribe@googlegroups.com。
若有更多问题，请通过 http://groups.google.com/group/perlchina?hl=zh-CN 访问此网上论坛。