摘要： 寫文檔的困惑寫文檔不像寫代碼，它沒有明確的好與壞，更沒有明顯的正確與不正確。也正因為此，對于寫慣了代碼的程序員來說，寫文檔是無比痛苦的，完全找不著北。寫短了，人家說沒寫清楚，太不詳細；寫得長了，人家說太瑣碎，那么長，哪有精力看。領導說，“這個問題簡單，兩三頁隨便描述一下就行了。”你若真是只寫個兩三頁，百分之百挨批。又要言簡意賅，又要表述詳盡。這比寫代碼要費勁多了。我們寫代碼時，講什么重構呀重構，有幾個人寫完代碼重構的？沒幾個吧。有哪一個寫完程序重構個十來回的？亙古少有吧。而寫文檔，隨便一個文檔，被重構個十來回、幾十回，甚至推倒重來個幾回都很正常。寫代碼與寫文檔，完全是兩個境界。要不怎么說，寫代 閱讀全文