人月神話劄記：提綱挈領

版權聲明：歡迎轉載，請注明沉默王二原創。 https://blog.csdn.net/qing_gee/article/details/45082469

前言：所謂提綱挈領，從字面上講就是抓住漁網的總繩，提起衣服的領子，其含義（度娘說要用含義而不推薦用涵義）就是告訴我們做事情要能夠抓住要領。那麼本篇告訴我們什麼是要領呢，就是書面文檔，從一開始就要意識到其重要性，那麼就不會對文檔産生厭煩。因為作為技術人員來說，包括我，普遍對文檔沒有好感，尤其是看完了長篇大論後，發現無非就是要表達一兩句話，那時候，就會氣急敗壞。

計算機産品的文檔

對于該小節，我讀了三遍，發現并沒有很好的了解，所謂預測->報價->價格之間互相制約的關系，沒有弄出來個是以然。希望在以後再次翻閱的時候能夠有很好的了解。

但是有一點，我覺得是個真理，那就是預算是一種制約，會促使産生更好的技術方案，因為如果在預算不能滿足目前項目所需的話，我們就會被迫去做出改變，去探索出更具有成本效益的産品解決方案，這促使了整個社會的發展。

大學科系的文檔

任何管理任務的關注焦點都是時間、地點、人員、項目内容和資金。

Brooks給出的這個觀點，我想沒什麼可說的，當你搬家告訴别人的時候，短信的内容就會是“各位親愛的夥伴們，我将于4月17日搬家至洛陽牡丹廣場，屆時歡迎大家光臨做客，我們将在老洛陽開吃一頓”。

軟體項目的文檔

就目前的自己來說，在安排任務的時候，多數是通過口頭傳達，然後在禅道中加入任務和時間，用來管理進度。而當一個任務結束後，等我再次回頭來進行總結的時候，發現我的記憶力不夠清晰了，往往這個時候，我非常的懷念有一份文檔能夠以書面的形式存在。

還有很多很多時候，對于一個開展的疊代，或者說一個關鍵的任務，或者說一個證明給别人的資料，強有力的文檔會讓所有的事情變得清晰明朗。

為什麼要有正式的文檔

這個看似疑問句的标題，其實更像是一個反問句，其答案必須是斬釘截鐵的，正式的文檔是必須的。

最近在做華夏銀行的三方存管平台對接工作，最開始，對這個對接的工作隻有幾個字的概念，就是“華夏銀行對接”。如果華夏銀行沒有提供給我必要的技術、業務說明文檔，我的印象恐怕隻能滞留在這六個字上了，雖然拿到他們的文檔後，閱讀過幾次後都感覺到無力，如今都2015年了，文檔的做成時間竟然是2011年，我不相信這4年來，業務接口一點沒變，憑我的直覺，後來又要到了兩份2014年做成的文檔。然而，我不應該吐槽這些文檔，我知道，正是這些文檔，促使我去思考，去讨論，去交流，去分析，去編碼，現在我已經把接口的代碼工作完成了，

接下來就是測試和上線。

那麼這些文檔的作用顯然是價值連城的，無論它的品質是否滿足我的預期。

項目經理的任務就是制定計劃，并且實作計劃。但是隻有書面計劃是精确和可以溝通的。通過遵循文檔開展工作，項目經理能夠更清晰和快速的設定自己的方向。

顯然，一次次的任務終結，其最讓我能夠感到滿足除了任務一次次終結，還有那被我折磨的文檔。