2025/09/21

「別再試圖撰寫完美的文件。繼續撰寫資訊，任何資訊，然後透過文字與圖像，利用有效溝通來建立共識。」——《使用者故事對照》

如果去問軟體工程師最討厭的事情是什麼，『寫文件』多半會是榜上前幾名的答案之一。

甚至在敏捷開發剛熱門發展的時期，也曾傳出一個重大的誤解，聽說跑敏捷不用寫文件。

寫文件真是一件既重要但又令人困擾的事情；不寫文件似乎會導致必要資訊及知識的遺漏，但寫了文件卻有可能導致資訊及知識的落後與失真。

因此就如本日金句所述，放棄吧！別再試圖撰寫完美的文件。這世上並沒有一份永不過期、永不失真、且適用於任何讀者的完美文件。

想要單靠文件，就讓所有人取得相同的共識與理解是不可能的。

因此這並不是要你不再撰寫文件，反而是要你有目的及目標的持續撰寫文件。

為了你想要達成的那項共識，去撰寫必要的文件，並以此與他人進行有效的溝通。

接受文件必然會過期，需要持續修正及持續溝通。

溝通、互動並取得共識，才是『寫文件』的重點。

你今天寫文件了嗎？喔，也許這問句應該改成，你今天與他人取得共識了嗎？