不給代碼寫文檔，讓代碼文檔化

這是程序員討論了很久的一個話題：要不要給代碼寫文檔？值得給代碼寫文檔嗎？ 我曾經覺得這個話題實在是讓人難以應付。也認爲除去一些特殊的情況（比如編寫公用 API），代碼文檔並不是那麼必要。直到有一天，我在一份代碼檢查報告中發現，缺少文檔被作爲一項缺點指出來。真是這樣的嗎？ 我曾經也給我的代碼寫文檔——至少我嘗試了。我曾深信你必須給代碼寫文檔。以後對我自己，或者對其他需要看我的代碼的程序員來說，文檔都

>>阅读原文<<