文檔，又是文檔

文檔，又是文檔，《敏捷建模》中關於文檔的一段文字，覺得非常好。

害怕失去所有的人而導致過度的文檔

很多組織機構害怕失去他們的軟體Team Dev，因為一旦團隊全部或大部分的人離開，非常重要而且常常沒有幾率的知識會和他們一起離開。常見的失去團隊的原因有：

有競爭者從你那裡掘走了團隊，以便啟動他們自己的項目
有的開發人員習慣性的跳來跳去，從不在任何公司久留。
在團隊剛剛完成項目之後你有意解散了他們。

為瞭解決這個問題，進階管理層常見的策略就是要求大量的文檔，他們相信一旦失去了這個團隊，可以簡單的組成另一個團隊，並把文檔交給新組成的團隊。這個辦法聽起來不錯，但在實際工作中常被證明起不了什麼作用。第一，儘管文檔可能對當前的情況有協助，但新來的團隊不大可能會相信它，他們寧願通過它得到關於系統的一個“地勢走向”，然後鑽進代碼以獲得細節。換句話說，他們使用詳細文檔可能只是為了包含在其中的一小部分概覽文檔。第二，這個策略經常會變成一個自我實現的預言，因為害怕他們會離開，你強制開發人員寫過量的文檔，而正因為你的官僚主義、缺乏對他們的信任和缺少對軟體開發的關注，他們會真的決定離開。

在這種情況下，我會和要求文檔的人一起工作，嘗試商議出一個更敏捷的方法。我的經驗是，由簡潔的概覽文檔和適當的契約模型支援的高品質原始碼，就能為將來需要維護和增強系統的開發人員提供一個足夠好的系統描述。