軟件設計說明練習

Question

有多少人在編寫單行代碼之前實際編寫SDD文檔？

你如何處理大型CSCI？

您對SDD內容使用什麼標準？

你做了什麼剪裁？

Answer 1

我當然有。歷史和最近的項目。
多年前，我曾在模板就是一切的組織中工作。 然後我在其他地方模板更寬鬆或者不存在，或者不適合我正在開發的項目。
現在，軟件設計的內容幾乎受到我需要描述的內容的支配，以便將觀點傳達給觀衆。
「在編寫單行代碼之前」不會有太多細節。我在開始編寫代碼之前編寫的文檔意在讓我們瞭解需要向受影響團隊和高級管理層建立什麼內容，以便他們引入高級架構，功能，技術，風險和範圍。後兩者非常重要。剩下的就是向其他團隊展示你需要與他們交流的地方，並讓管理者留下一個令人期待的事情。

Answer 2

大多數大型軟件公司都有自己的做法。例如，摩托羅拉就軟件開發過程的每個方面都有詳細的文檔。每種文檔都有標準模板。擁有嚴格的標準可以有效地維護大量文檔並將其與不同工具集成。每個文件從特殊文件追蹤系統獲得追蹤號碼。他們甚至有系統（上次我看到它處於早期開發階段）用於自動需求跟蹤 - 您可以說哪一行代碼與給定的需求\設計準則相關。

Answer 3

我想大多數編寫SDD文檔並使用像CSCI這樣的術語的人必須使用特定的軟件開發方法，並且很可能正在爲一些嚴肅的政府客戶工作。他們通常傾向於認真對待他們的準備工作，並在開始任何開發之前準備並批准文件。

在敏捷過程中，開發和設計文檔可以並行開發。這意味着將會有大量的重構工作要做​​，但最終通常會帶來非常好的結果。

在更正式的流程（如RUP）中，SAD文檔主要是在基於團隊研究的細化/原型階段創建的。