🎋 竹子日誌

講了很多次,要寫文件!

很多人誤以為寫文件是要給工程師看需求的,常常覺得在需求會議都討論好了,工程師也清楚也正確完成需求,為什麼又要寫文件?

最近聽到一段故事,有一個產品是一間新創公司的主力產品,大概團隊有10多位成員極力開發一個平台,隨著平台越來越大,公司也跟著一起成長。有一天團隊成員和老闆發生了不愉快,人員大規模出走,老闆無奈只能再找人維護產品,因為要靠這個產品賺錢。然後,新的團隊找來了,但產出卻低下的非常嚴重,QA發現新團隊開發的Bug現率超高,特別是舊功能修改,團隊主管去了解一下發生什麼事。不問還好,一問才知道,工程師和PM花了很多時間研究「原功能」的設計理念和系統邏輯,有時排程一趕也只能寫寫出來不要管會不會造成舊系統出問題。

到底發生什麼事?

其實文件真正的用途是給「後手」看的,沒有文件的情況下,新來的對於這個產品會有成堆成山的疑問,不清楚到底為什麼需求當時這麼設計是為什麼。很多時候不能因為懶惰而推卸責任說:「當時這麼設計一定有用意,不要亂改」這種不負責任的發言。

永遠就有人嫌寫文件很麻煩,就是有人把寫文件擺在後面考慮,沒了文件功能是難以維護的。如果開發的軟體不是接案性質那種拋棄式的需求,而是講究長期維護的,沒有文件針對會大大提高開發的困難指數。

總而言之。

有文件查舊東西,叫考古。

沒文件⋯⋯⋯叫通靈

留言