軟件設計的哲學：第二十章 為什么要寫注釋
目錄 12.1 好代碼是自我解釋的 12.2 我沒有時間寫注釋 12.3 注釋會過時並產生誤導 12.4 我所看到的一切注釋都是毫無價值的 12.5 良好的注釋的好處 代碼內文檔在軟件設計中起着至關重要的作用。 注釋對於幫助開發人員理解系統和有效地 ...
原文：軟件設計的哲學： 第十五章 先寫注釋
目錄 . 延遲的注釋是糟糕的注釋 . 先寫注釋 . 注釋是一個設計工具 . 早期的注釋很有趣 . 早期的注釋代價高昂嗎 . 結論 許多開發人員將編寫文檔的工作推遲到開發過程的末尾，即編碼和單元測試完成之后。這是產生低質量文檔的最可靠的方法之一。編寫注釋的最佳時間是在過程的開始，即編寫代碼的時候。 首先編寫注釋使文檔成為設計過程的一部分。這不僅產生了更好的文檔，而且還產生了更好的設計，並使編寫文檔 ...
2019-12-26 10:04 1 679 推薦指數：
相關推薦
軟件設計的哲學： 第九章 合並還是分解
9.9 結論 軟件設計中最基本的問題之一是：給定兩部分功能，它們應該在同一個地方一起實 ...
軟件設計的哲學 第五章 隱藏信息
結論 第四章論述了模塊的深度。本章以及隨后的幾章將討論創建深度模塊的技術。 5.1 信息隱 ...
軟件設計的哲學：前言
。所有這些討論都是有價值的，但是軟件設計的核心問題在很大程度上仍然沒有觸及。David Parnas的經典 ...
軟件設計的哲學：第十三章 注釋應該描述代碼中隱藏的內容
目錄 13.1 選擇約定 13.2 不要重復代碼 13.3 低級注釋增加了精確性 13.4 更高層次的注釋增強直覺 13.5 接口文檔 13.6 建議：什么和為什么，而不是如何 13.7 跨模塊設計決策 13.8 結論 13.9 對第13.5 ...
軟件設計的哲學【翻譯】--目錄
2020年必讀書籍推薦：軟件設計的哲學（A Philosophy of Software Design），本書190多頁，豆瓣的點評分在9分以上，目前只有英文版本，中文版還未上市，英文好的同學建議去直接閱讀原版。 作者簡介 John Ousterhout是斯坦福大學計算機科學教授。他目前 ...
2020薦書：軟件設計的哲學
2020年必讀書籍推薦：軟件設計的哲學（A Philosophy of Software Design），本書190多頁，豆瓣的點評分在9分以上，目前只有英文版本，中文版還未上市，英文好的同學建議去直接閱讀原版。 內容簡介 書中討論了軟件設計的主題：如何將復雜的軟件 ...
軟件設計的哲學： 第六章 更深的通用模塊
目錄 6.1 使類具有一定的通用性 6.2 示例：為編輯器存儲文本 6.3更通用的API 6.4 通用性使得信息隱藏效果更好 6.5 問自己的問題 6.6 結論 在設計新模塊時，最常見的一個決定就是以通用方式還是特殊方式實現它。有些人可能會 ...