摘要: 写文档的困惑写文档不像写代码,它没有明确的好与坏,更没有明显的正确与不正确。也正因为此,对于写惯了代码的程序员来说,写文档是无比痛苦的,完全找不着北。写短了,人家说没写清楚,太不详细;写得长了,人家说太琐碎,那么长,哪有精力看。领导说,“这个问题简单,两三页随便描述一下就行了。”你若真是只写个两三页,百分之百挨批。又要言简意赅,又要表述详尽。这比写代码要费劲多了。我们写代码时,讲什么重构呀重构,有几个人写完代码重构的?没几个吧。有哪一个写完程序重构个十来回的?亘古少有吧。而写文档,随便一个文档,被重构个十来回、几十回,甚至推倒重来个几回都很正常。写代码与写文档,完全是两个境界。要不怎么说,写代 阅读全文
posted @ 2012-07-17 15:52 songsoft 阅读(2419) 评论(3) 推荐(3) 编辑