文件的謬思

2016 10 18


規(guī)格文件該怎麼撰寫?

相信團(tuán)隊(duì)中的每個(gè)角色都有各自的看法,大家所持的意見(jiàn)都有各自的道理,也都有其優(yōu)缺點(diǎn)。

  1. RD 期待的文件

希望只要照著文件的指示開(kāi)發(fā)即可,不需要?jiǎng)幽X去思考文件內(nèi)容。

  1. QA / QC 期待的文件

希望文件能包含開(kāi)發(fā)實(shí)作的邏輯及狀態(tài),讓產(chǎn)品的測(cè)試案例能夠更完整。

  1. 業(yè)務(wù)期待的文件

希望每個(gè)畫面、每個(gè)功能都有詳盡的說(shuō)明,讓客戶的問(wèn)題能夠快速找到解答。

然而,我們常常被自己不切實(shí)際的期待與幻想綁架,希望能有一份文件是能夠幫助自己工作更為順暢,卻忘了去了解文件是怎麼生產(chǎn)出來(lái)的,也忘了文件是要給人看的。

該為了滿足每個(gè)人的期待而分別撰寫三份文件?還是同一份文件盡可能滿足個(gè)別需求?以及未來(lái)如何共同維護(hù)、更新文件都將是一大難題。


常見(jiàn)的謬思

  1. 規(guī)格文件寫得越多、越詳細(xì)、越完整越好。

越多越詳細(xì)越完整,代表文件很龐大累贅,查詢不便、修改維護(hù)不易、所耗費(fèi)的隱藏工時(shí)也有可能日積月累,最後成為團(tuán)隊(duì)的負(fù)擔(dān)。

  1. 規(guī)格一但交付後,要修改得經(jīng)過(guò)重重關(guān)卡審核,避免反覆的修改造成不必要的工時(shí)成本。

早期的 Waterfall 流程也許適用這種做法,但現(xiàn)在市場(chǎng)狀況、用戶喜好瞬息萬(wàn)變,改一個(gè)需求若需經(jīng)過(guò)一兩個(gè)禮拜的時(shí)間才能定案,早就喪失市場(chǎng)先機(jī)。

  1. 認(rèn)為文件做得好,產(chǎn)品才能做得好。

文件的好壞取決於團(tuán)隊(duì)成員是否能夠清楚透過(guò)此文件進(jìn)行溝通,就算文件格式再完整、寫得再好,沒(méi)人看的文件就是不需要存在的文件!


文件怎麼寫才好?

這其實(shí)沒(méi)有一定的答案,根據(jù)不同產(chǎn)品屬性、組織架構(gòu)、企業(yè)文化...等不同,會(huì)有各自合適的做法。

下面提供幾個(gè)思考的切入點(diǎn)做參考

  • 目前產(chǎn)品處?kù)妒颤N時(shí)期?

如果只是在開(kāi)發(fā) MVP,都還不確定是否會(huì)長(zhǎng)期經(jīng)營(yíng)下去,根本不必在乎是否有正式的規(guī)格文件,你需要在意的是目前的溝通效率夠不夠高!

  • 了解產(chǎn)品跟團(tuán)隊(duì)特性

若你們的產(chǎn)品是販?zhǔn)劢o企業(yè)客戶,對(duì)外理當(dāng)會(huì)有制式規(guī)格書。
若是針對(duì)一般市場(chǎng)使用者,你該在意的是怎麼吸引用戶來(lái)使用你的產(chǎn)品,而不是寫一長(zhǎng)串的說(shuō)明文件,記住!沒(méi)有用戶會(huì)看你的說(shuō)明文件!

  • 維護(hù)文件的成本是否值得

要記住,寫文件是為了溝通!若維護(hù)文件的成本高於寫好文件所省下來(lái)的溝通成本,那你得好好衡量這樣做是否恰當(dāng)。
若演變到最後,整個(gè)團(tuán)隊(duì)都花許多時(shí)間在維護(hù)文件上就變得本末倒置了!

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
平臺(tái)聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點(diǎn),簡(jiǎn)書系信息發(fā)布平臺(tái),僅提供信息存儲(chǔ)服務(wù)。

推薦閱讀更多精彩內(nèi)容

  • 程序員創(chuàng)業(yè)白皮書 作者:Paul Graham Paul Graham是程序員,專欄作家。他在1995年創(chuàng)建了第一...
    劉立山John閱讀 1,965評(píng)論 0 20
  • 突然聽(tīng)到groove coverage 的far away from home,瞬間大學(xué)的時(shí)光都展現(xiàn)在眼前,好像代...
    Sammie云閱讀 192評(píng)論 0 0
  • Android在發(fā)布 5.0(Lollipop)版本之后,Google為我們提供了嵌套滑動(dòng)(NestedScrol...
    AndroidCJJ閱讀 11,804評(píng)論 7 48
  • 風(fēng)丟了我給你的信 那天夜里我失落了很久很久 月光惆悵的撫摸著我的臉不知該說(shuō)什么 風(fēng)哭了 那天夜里夢(mèng)失落了很久很久 ...
    心花園子閱讀 71評(píng)論 0 0