天天看點

《人月神話》閱讀筆記03

      看完整本書我看到作者一直再強調文檔的重要性,他曾經很勤奮的向軟體工程師們講述文檔的必要性以及優秀文檔所具有的特點方面的講座。但是效果都非常的的不好,他們知道如何來寫出優秀的文檔,但是他們缺乏熱情。是以作者采用向馬車搬收銀機的方法向他們展示如何來完成這項工作。結果顯示這種方法的效果還是挺好的。那我們在開發的過程中需要什麼樣的文檔呢?

    不同使用者需要不同級别的文檔。 某些使用者僅僅偶爾使用程式, 有些使用者必須依賴程式,還有一些使用者必須根據環境和目的的變動對程式進行修改。使用程式。 每個使用者都需要一段對程式進行描述的文字。可是大多數文檔隻提供了很

少的總結性内容,無法達到使用者要求,驗證程式。 除了程式的使用方法, 還必須附帶一些程式正确運作的證明, 即測試用例。修改程式。 調整程式或者修複程式需要更多的資訊。顯然,這要求了解全部的細節,并且這些細節已經記錄在注釋良好的清單中。 和一般使用者一樣, 修改者迫切需要一份清晰明了的概述。

    另外一個讓我印象深刻的觀點是:要保證一個項目的進度被大幅度推遲,制定進度表很重要。進度表由裡程碑和完成時間組成。裡程碑必須具體,明确,可界定。某一裡程碑要麼到達,要麼沒有到達,不應該是80%到達的。而我的經驗是,制定進度表非常重要,而且要求制定者有很強的技術背景,這樣才能對碰到的問題和可能花掉的時間做出更準确的估計。