文件真的很重要嗎?


當初開始教 scrum 時, 很多人問我敏捷宣言說不用寫文件, 這是真的嗎? 讓我們來看看原文吧

Individuals and interactions over processes and tools
Working software over comprehensive documentation
Customer collaboration over contract negotiation
Responding to change over following a plan

That is, while there is value in the items on the right, we value the items on the left more.

雖然在第二列說"可用的軟體重於詳盡的文件." 但是不要忘記最後一句也提到: "也就是說, 雖然右側項目有其價值, 但我們更重視左側項目".

是的, 右側項目是有其價值的. 雖然 agile 比較重視左側項目, 但是不代表右側項目沒有用.

只可惜, 不同角色的會對相同的句子, 有著不同的解釋. 就像九二共識一樣, 兩岸三黨各自有各自自己的說法.

人們之所有會需要文件, 是因為他遇到問題了, 不知道要如何處理, 因此需要找尋解答, 而文件便是其中一種解法. 可是只有文件能幫助嗎? 當然不是, 直接問知道答案的人, 或者看 video 教學也是可以解決問題.

在過年期間, 小弟便遇到活生生的例子.

我們偉大的 sales, 憑著一股熱忱, 想要幫我們把產品賣給印度的客戶. 雖然他們不會使用我們的產品, 但是為了幫助公司獲利, 因此義不容辭地把我們產品直接裝在客戶 production 環境.

結果裝不起來時, 第一件事情就不是看文件, 是約遠端連線, 幫他們直接重頭到尾設定好.

由 於他們聽過我們產品的特色是 sandbox image 可以客製化, 便把 B 產品的 sandbox image, 直接在客戶環境上 import 進去, 結果當然不能 work. 雖然我們的文件有寫要設定要如何設定課製化 sandbox image, 但是還是約遠端連線, 這樣比較快解決問題.

此外 PM 覺得這些問題常常發生, 建議我們開發團隊, 要準備一支錄影帶教學, 讓 sales 和 support 可以快速上手.

所以這告訴我們甚麼呢? 文件寫好是基本的, 但是為了溝通方便, 和快速得到答案, 文件不是最好的解法.

Agile 希望你能考慮其他的做法, 讓工作可以更有效率.
 

arrow
arrow
    全站熱搜

    kojenchieh 發表在 痞客邦 留言(0) 人氣()