需求文檔編寫常遇到的問題?怎么破?

4 評論 49515 瀏覽 299 收藏 12 分鐘

“文章本天成,妙手偶得之?!睂懶枨笪臋n不需要“妙手”,但需要思路清晰、敘述清楚。寫的人要能把需求寫透,看的人才能看懂,一篇好的需求文檔能答疑解惑,一篇壞的需求文檔會讓人誤入歧途。

有一天,一個朋友打電話給我。

朋友:“上回聽說你們公司是做產(chǎn)權(quán)的,我這有訴訟相關(guān)的項目,你們能做嗎?”

老吳:“公司現(xiàn)在不打算接項目了,以做產(chǎn)品為主?!?/p>

朋友:“你在公司負(fù)責(zé)什么???”

老吳:“我是產(chǎn)品經(jīng)理,負(fù)責(zé)公司的產(chǎn)品。”

朋友:“哦,做需求的啊,知道了。

老吳:“……”

每個公司對產(chǎn)品經(jīng)理的定位都不同,有的產(chǎn)品經(jīng)理負(fù)責(zé)產(chǎn)品的需求,有的產(chǎn)品經(jīng)理負(fù)責(zé)產(chǎn)品的設(shè)計,有的產(chǎn)品經(jīng)理負(fù)責(zé)整個產(chǎn)品線。不論給產(chǎn)品經(jīng)理的定位是什么,需求對產(chǎn)品經(jīng)理來說都是必做的功課,那么,寫需求文檔就成了我們的家常便飯。對于不同的大廚來說同樣做一道家常菜,有的做的色、香、味俱全,吃起來入口綿長、滑嫩可口;有的做的熟悉親切、感人落淚如媽媽的味道;有的做的外焦里嫩、清香撲鼻;但也有的做的慘不忍睹、不忍直視。做產(chǎn)品也是一樣,不同的人對產(chǎn)品有著不同的理解,就算理解一樣,寫出來的產(chǎn)品文檔也會不同。

那么,產(chǎn)品經(jīng)理在整個需求階段要寫哪些文檔呢?

商業(yè)需求文檔BRD、市場需求文檔MRD、產(chǎn)品需求文檔PRD、技術(shù)需求文檔(需求規(guī)格說明書)。

  • 商業(yè)需求文檔BRD。它是一種商業(yè)的需求描述,里面要體現(xiàn)產(chǎn)品的市場分析、規(guī)劃、投入、盈利預(yù)測等信息,是為了讓決策層便于分析、決策是否開發(fā)此產(chǎn)品的依據(jù),商業(yè)需求文檔更像是商業(yè)計劃書,它是需求階段最早需求提供的文檔,文檔一般不長,也可以是PPT的方式展示。
  • 市場需求文檔MRD。市場需求文檔是站在市場、用戶的角度,多描述用戶、購買者、客戶的需求,它是承上啟下的文檔,對技術(shù)需求文檔的編寫起到一定的指導(dǎo)作用。文檔中多會加入原型的形式將產(chǎn)品具體化,便于文檔的解釋說明。
  • 產(chǎn)品需求文檔PRD。產(chǎn)品需求文檔多是站在業(yè)務(wù)的角度,讓所有的項目干系人都能夠了解、理解產(chǎn)品而編寫的,此文檔的閱讀者為產(chǎn)品的管理層、需求人員、設(shè)計人員、技術(shù)人員、測試人員、市場人員、運營人員。

需求規(guī)格說明書,此文檔是站在技術(shù)角度而編寫,文檔中不僅要描述產(chǎn)品的業(yè)務(wù)需求,還要描述產(chǎn)品的技術(shù)指標(biāo)和技術(shù)參數(shù),是架構(gòu)設(shè)計、技術(shù)開發(fā)的指導(dǎo)性文檔。為了便于說明需求,文檔中會加入流程圖、序列圖、原型圖等設(shè)計模型,更好的讓技術(shù)人員理解、指導(dǎo)技術(shù)人員開發(fā)。

根據(jù)公司情況不同,PRD、MRD、BRD文檔不一定都需要編寫,這要看各公司的具體情況。我認(rèn)為讓非技術(shù)人員理解產(chǎn)品一定要有產(chǎn)品需求文檔,指導(dǎo)技術(shù)開發(fā)一定要有需求規(guī)格說明書。產(chǎn)品經(jīng)理要寫這么多文檔,需要貫徹產(chǎn)品的整個需求階段,那么產(chǎn)品經(jīng)理一定要是一名好的方案編寫高手。

我們了解了各類文檔,也知道了他們的價值和作用,那么,文檔的編寫需要注意哪些方面呢?

正確性

我們經(jīng)過調(diào)研、分析得到需求后,整理成文檔,以便于信息的保存與傳播。需求在腦子里的時可能是清晰的,但寫出來后就不一定清晰了。原因是,你腦子里想的可能是A,寫出來后可能是A1,但你還以為寫的是A。錯誤的原因有很多可能是你的文筆不好、也可能是疏忽、還可能是你沒有把需求寫透,還有一種可能就是你當(dāng)初就沒有正確的理解需求。

e1

全面性

我們在獲取需求時盡量全面的了解問題,得到真實、準(zhǔn)確、完整的需求,只有獲取的信息全面寫出來的需求才可能全面。另外,就算獲取需求全面了,有時寫需求時也難免有所疏漏。所有,在編寫需求時要考慮全面,建議從大到小、從粗到細(xì)進行梳理,從平臺、子系統(tǒng)、模塊、功能點一條一條線進行梳理,當(dāng)所有的流程都遍歷完成后需求文檔也就整理完成了。

e2

可驗證性

需求文檔中所描述的需求應(yīng)該是可驗證的,如商業(yè)文檔的商業(yè)數(shù)據(jù)的出處。對于技術(shù)文檔來說,功能要有輸入項、輸出項、事前描述、約束條件,當(dāng)一切條件都滿足后,輸入什么樣的數(shù)據(jù)應(yīng)該輸出什么樣的結(jié)果。對于市場需求文檔,要體現(xiàn)用戶的邏輯思維,為什么用戶會用這樣的功能,依據(jù)是什么?是經(jīng)過推理、還是心理暗示?文檔中的信息應(yīng)該是可推敲、可驗證的,只有保證數(shù)據(jù)及信息來源的正確性,才能更好的把握產(chǎn)品。另外,只有需求文檔各接口、屬性、參數(shù)具備可驗證性,測試人員才好根據(jù)需求文檔編寫測試用例。

無二義性

中文有多音、多義字,英文也有一個單詞代表多種含義的情況,因為文檔主要是文字描述,在文檔中難免有二義性的情況。在文檔的描述中一定要保證含義清晰,表達(dá)準(zhǔn)確。還有一種情況,就是有時產(chǎn)品經(jīng)理自己對產(chǎn)品需求理解模糊,思考不深刻,在寫文檔時就不可能保證文檔的準(zhǔn)確性。

必要性

不同的需求文檔是站在不同的角度上思考問題的,當(dāng)我們從多重角度分析問題時,會對產(chǎn)品有更深刻的理解,哪些需求是必要的,哪些需求是次要的,哪些需求是可要可不要的。當(dāng)一個產(chǎn)品中充斥著非必要性需求,就是喧賓奪主,有時要該“砍”則“砍”,壯士斷臂。

優(yōu)先級

在產(chǎn)品中加入優(yōu)先級,有助于讓相關(guān)人理解產(chǎn)品中各功能的重要度,在必要時(如開發(fā)時間緊張時)也可以考慮優(yōu)先完成哪些功能。另外,在產(chǎn)品文檔中加入優(yōu)先級,也便于產(chǎn)品的版本升級。但優(yōu)先級,我認(rèn)為不用分得太細(xì),只需要加上“高”、“中”、“低”就好了。

以上問題都是在做產(chǎn)品文檔時需要注意的問題,做為產(chǎn)品經(jīng)理,我們在獲取、分析需求時,一定要對需求準(zhǔn)確把握,不可以有理解模糊、分析不透徹的情況。否則,在編寫文檔時就會出現(xiàn)更多的問題,當(dāng)你再折回去重新分析需求時會浪費更多的時間和精力。需求文檔的編寫是一個很吃功力的事情,難的不是寫,而是想,只有想透了寫其它是件很容易的事。就跟寫文章一樣,在寫前在大腦中會想好題綱,寫時思路就會非常清晰。建議產(chǎn)品經(jīng)理,在寫文檔前一定要把需求想清楚,也可以借助一些模型工具,如VISIO、AXURE等,通過模型會有利于幫助我們整理思路、梳理需求。

需求文檔的編寫是一件很費時、費力的事情,大多數(shù)公司都會認(rèn)真編寫需求文檔嗎?需求文檔的下場一般會是什么樣的呢?

  • 一、在很多公司,產(chǎn)品的前期和開發(fā)階段,文檔都會非常重視,當(dāng)產(chǎn)品一旦進入開發(fā)后期或完成后,文檔就會束之高閣,經(jīng)過多輪的產(chǎn)品迭代后,文檔與產(chǎn)品間就會完全脫節(jié),這就是需求失敗的信號。
  • 二、許多企業(yè)為了趕項目工期,前期只是有簡單的設(shè)計就進入開發(fā)階段,而且對外聲稱自己是“敏捷開發(fā)”,敏捷成為不用寫文檔的借口。實際,在開發(fā)階段,需求文檔是非常重要的,它將有效的指導(dǎo)開發(fā)工作,讓技術(shù)人員按照統(tǒng)一的標(biāo)準(zhǔn)實施,它將有利于讓技術(shù)人員統(tǒng)一思想,開發(fā)時也不用頻繁的進行溝通,前期需求階段多思考后開發(fā)階段就可以節(jié)省大量的時間。敏捷只適用于小團隊作戰(zhàn),在大項目中,開發(fā)文檔將保證所有的技術(shù)人員按照有序的、準(zhǔn)確的方向前行。
  • 三、很多公司為了應(yīng)付客戶或領(lǐng)導(dǎo),在產(chǎn)品開發(fā)完成后補文檔,這時編寫的文檔基本上沒有什么價值了,真正要做好產(chǎn)品,需求文檔的編寫是成功的必要條件。

需求文檔在產(chǎn)品團隊中要如何使用和管理呢?

需求文檔應(yīng)該是共享的,所有項目參與人都可見,一方面有利于干系人理解產(chǎn)品,還有利于其它人提出不同的意見和見解,幫助產(chǎn)品優(yōu)化。在項目中盡量用一些版本管理工具來管理文檔,如CVS、VSS。這些版本管理工具可以設(shè)置權(quán)限,哪些人可以看哪些文檔,哪些人可以修改哪些文檔,在版本管理工具中都可以實現(xiàn)。另外文檔要可維護,隨著需求的變更需求文檔也會跟著變化,要保證需求文檔與產(chǎn)品功能一致。另外,為了保證產(chǎn)品文檔的風(fēng)格一致,盡量讓專人負(fù)責(zé)文檔的維護工作。

 

本文由 @產(chǎn)品人老吳(微信公眾號:ChanPinLaoWu) 原創(chuàng)發(fā)布于人人都是產(chǎn)品經(jīng)理。未經(jīng)許可,禁止轉(zhuǎn)載。

更多精彩內(nèi)容,請關(guān)注人人都是產(chǎn)品經(jīng)理微信公眾號或下載App
評論
評論請登錄
  1. 大佬,請問你們一般使用什么工具可以團隊管理需求文檔且權(quán)限管理和評論等功能等???

    來自湖南 回復(fù)
  2. 其中的一句話我很認(rèn)同,我們公司就是敏捷開發(fā),開始的需求文檔很簡陋。感覺學(xué)不到什么東西

    來自四川 回復(fù)
  3. 好文啊

    來自上海 回復(fù)
  4. good! ??

    來自上海 回復(fù)