軟件設計的哲學： 第十五章 先寫注釋
目錄 15.1 延遲的注釋是糟糕的注釋 15.2 先寫注釋 15.3 注釋是一個設計工具 15.4 早期的注釋很有趣 15.5 早期的注釋代價高昂嗎? 15.6 結論 許多開發人員將編寫文檔的工作推遲到開發過程的末尾，即編碼和單元測試完成之后 ...
原文：軟件設計的哲學：第十三章 注釋應該描述代碼中隱藏的內容
目錄 . 選擇約定 . 不要重復代碼 . 低級注釋增加了精確性 . 更高層次的注釋增強直覺 . 接口文檔 . 建議：什么和為什么，而不是如何 . 跨模塊設計決策 . 結論 . 對第 . 節問題的回答 編寫注釋的原因是，在編寫代碼時，編程語言中的語句無法捕獲開發人員頭腦中的所有重要信息。注釋記錄了這些信息，以便以后的開發人員能夠很容易地理解和修改代碼。注釋的指導原則是注釋應該描述代碼中不明顯的內容 ...
2019-12-24 09:50 0 854 推薦指數：
相關推薦
軟件設計的哲學：第二十章 為什么要寫注釋
目錄 12.1 好代碼是自我解釋的 12.2 我沒有時間寫注釋 12.3 注釋會過時並產生誤導 12.4 我所看到的一切注釋都是毫無價值的 12.5 良好的注釋的好處 代碼內文檔在軟件設計中起着至關重要的作用。 注釋對於幫助開發人員理解系統和有效地 ...
軟件設計的哲學 第五章 隱藏信息
目錄 5.1 信息隱藏 5.2 信息泄漏 5.3 時間分解 5.4示例：HTTP服務器 5.5 示例：類太多 5.6 示例:HTTP參數處理 5.7 示例:HTTP響應中的默認值 5.8 隱藏在類中的信息 5.9 不要過度隱藏 5.10 ...
軟件設計的哲學：前言
。所有這些討論都是有價值的，但是軟件設計的核心問題在很大程度上仍然沒有觸及。David Parnas的經典 ...
軟件設計的哲學：第十八章 代碼的可見性
目錄 18.1 使代碼更簡單的東西 18.2 使代碼不那么明顯的事情 18.3 結論 晦澀是2.3節中描述的復雜性的兩個主要原因之一。當系統的重要信息對新開發人員來說不明顯時，就會出現模糊現象。模糊問題的解決方案是用一種簡單易解的方式來寫代碼。本章討論 ...
軟件設計的哲學：第十六章 修改現有代碼
目錄 16.1 保持戰略 16.2 維護注釋：將注釋放在代碼附近 16.3 注釋屬於代碼，而不是提交日志 16.4 保留注釋：避免重復 16.5 維護注釋：檢查差異 16.6 更高級別的注釋更容易維護 第1章描述了軟件開發是如何迭代和增量 ...
軟件設計的哲學：第三章 編程的戰術和戰略
“ 作者簡介： 常柱，微信公眾號【架構未來】作者，十多年一線互聯網研發從業經驗；前五八同城商業會員技術負責人，寶駕租車技術總監，現58 到家業務中台技術負責人。 好的軟件設計最重要的元素之一是在處理編程任務時采用的思維方式。許多組織鼓勵一種戰術心態，專注 ...
軟件設計的哲學【翻譯】--目錄
2020年必讀書籍推薦：軟件設計的哲學（A Philosophy of Software Design），本書190多頁，豆瓣的點評分在9分以上，目前只有英文版本，中文版還未上市，英文好的同學建議去直接閱讀原版。 作者簡介 John Ousterhout是斯坦福大學計算機科學教授。他目前 ...