《資料結構與抽象：Java語言描述（原書第4版）》一P.2 說明方法

本節書摘來華章計算機《資料結構與抽象：java語言描述（原書第4版）》一書中的第1章 ，第1節，［美］弗蘭克m.卡拉諾（frank m. carrano）　蒂莫西m.亨利（timothy m. henry） 著 羅得島大學　 新英格蘭理工學院 辛運帏　饒一梅　譯 更多章節内容可以通路雲栖社群“華章計算機”公衆号檢視。

将類的目标及方法與其實作分開，對一個成功的軟體項目來說是至關重要的。應該說明每個類及方法，而不關心它的實作。寫這些描述能捕捉到你最初的想法，并開發它們，進而才能足夠明确地實作它們。你寫的描述應該作為注釋放到程式中有用的地方。你不能在寫了程式之後為了應付老闆才寫注釋。