「敏捷初學者會認為敏捷沒有說明文件。但這是不正確的。敏捷建議我們要選擇那些有用的說明文件。」——《Specification by Example 中文版》

我們不寫文件，因為我們在跑 Agile。

這大概是可排入前十名的 Agile 誤解了。

敏捷宣言說的是「可用的軟體 重於 詳盡的文件」，是在提醒我們別為了文件而文件，並不是叫你什麼都不要記錄。

而且越是在一個快速迭代、頻繁交接的軟體團隊裡，好文件的存在甚至比任何時候都更重要。

好的文件讓知識可以流動，而不是被鎖在某個人的腦袋裡。

從這個角度來看，DevOps 的 Everything as Code，其實也是一種文件化的實踐，它不只是 Code，也是一種文件。

所以，文件並不是不重要，而是我們需要花心思去選擇那些真正有用的文件。

寫文件不是罪，怕的是寫了一堆沒人看、也幫不上任何忙的文件。

你們團隊現在的文件，是在幫助大家把事情做好，或只是用來應付某個需要交付文件的流程呢？