所有註解都沒用？

這個藉口最有道理。

一個事實#

每位開發者都看過毫無用處的註解，現存大部分文件頂多差強人意。

寫好的文件並不困難——只要你知道方法。

接下來幾章會給出寫好註解的框架，並討論如何隨時間維護它們：

別讓「過去看過爛註解」這個經驗成為你寫不出好註解的藉口。