2009-04-08 156 views
2

我寫了一些精心設計的開源Java項目的一些建議的請求,其中包含良好的設計文檔 - 特別是隨着更多人看着它(並提出瑕疵?)在建議的設計中)。開源的Java項目(具有良好的設計文檔)

我記得讀過Joel Spolsky關於軟件產品(或項目)中大多數價值的評論來自良好的設計。雖然他發表了一個良好功能規範(CoPilot)的例子,但他(遺憾地)沒有公佈這個功能規範如何隨後轉化爲技術規範和最終產品的設計。

目前,我正在嘗試參與開源項目,以發展我的Java技能。我處於一個高原(爲了進步),我需要更深入地瞭解一個項目是如何從功能需求演變到技術設計的,這樣我可以在融合當前存在的代碼基礎之前考慮所考慮的問題。

我看到的大多數開源Java項目似乎都沒有關於在融合當前存在的設計(代碼)之前考慮過哪些問題的任何信息。我確信有人(至少)必須(至少)發佈了一個類圖來模擬不同實體之間的關係,並說明爲什麼它是以這種方式設計的。

任何指針將不勝感激。

親切的問候, Dinuk

回答

3

看Apache項目。他們大多記錄得很好,並且擁有活躍的開發用戶郵件列表,您可以從中獲取超出記錄內容的信息。除了在郵件列表中查看過去的對話外,您還會看到出現了哪些問題以及解決方法。