PRD七坑:沒有可讀性的PRD都是耍流氓

寫PRD并不是產(chǎn)品經(jīng)理的全部工作蹋凝,但卻是不可少的一部分脐瑰,一份可讀性的PRD對(duì)一個(gè)項(xiàng)目團(tuán)隊(duì)來說是至關(guān)重要的。

突發(fā)事件

昨天編輯了一篇純邏輯修改的文檔魄衅,交付開發(fā)后峭竣,開發(fā)方向偏離,后臺(tái)大量訂單數(shù)據(jù)出錯(cuò)出錯(cuò)晃虫。

我立馬叫停開發(fā)人員皆撩,交流之后,發(fā)現(xiàn)開發(fā)人員錯(cuò)誤理解了PRD文檔哲银。開發(fā)人員在閱讀文檔的時(shí)候直接看掉了兩個(gè)字毅访。

后來我自己回去閱讀的時(shí)候也看錯(cuò)了沮榜,說明我文檔是不易讀盘榨。所以一方面叫開發(fā)人員停下來修復(fù)數(shù)據(jù)出錯(cuò)的地方喻粹,一方面重新整理文檔。

下面我就介紹一下我在梳理文檔過程中發(fā)現(xiàn)的幾個(gè)坑草巡。

第一坑——名詞交流混亂

這是昨天文檔中最大的問題守呜,因?yàn)楹笈_(tái)是管理訂單的,所以會(huì)有大量的時(shí)間結(jié)點(diǎn)山憨,但是目前只有兩個(gè)時(shí)間結(jié)點(diǎn)有自己的專屬名字查乒。其他的時(shí)間結(jié)點(diǎn)的叫法都是今天一個(gè)樣,明天一個(gè)樣郁竟。

所以我在寫文檔的時(shí)候就按照自己的叫發(fā)來寫文檔玛迄,其中就有一系列相似名稱的時(shí)間結(jié)點(diǎn)叫做“服務(wù)時(shí)間”、“次服務(wù)時(shí)間”棚亩、“官方服務(wù)時(shí)間”蓖议,技術(shù)同學(xué)在開發(fā)的時(shí)候,直接把“官方服務(wù)時(shí)間”的“官方”二字看掉了讥蟆。

看錯(cuò)后就直接對(duì)“服務(wù)時(shí)間”的先關(guān)內(nèi)容進(jìn)行大刀闊斧的修改勒虾,所以就導(dǎo)致后臺(tái)訂單數(shù)據(jù)錯(cuò)亂。于是乎經(jīng)過交流瘸彤,終于重新定名“服務(wù)時(shí)間”修然、“訂單時(shí)間”、“官方時(shí)間”质况。

關(guān)鍵詞命名的注意點(diǎn):

  1. 整個(gè)團(tuán)隊(duì)要將關(guān)鍵詞進(jìn)行統(tǒng)一愕宋,最好創(chuàng)建規(guī)范性名詞解釋列表;
  1. 關(guān)鍵詞命名時(shí)结榄,同一個(gè)模塊中贝、流程中的詞語里邊相同字的使用不要超過50%;
  2. 還有產(chǎn)品設(shè)計(jì)各個(gè)環(huán)節(jié)中潭陪,關(guān)鍵詞的一致性雄妥,也是需要注意的。

第二坑——專業(yè)名稱重復(fù)出現(xiàn)

昨天在寫文檔的時(shí)候依溯,為了使每一個(gè)名詞都能精確的定位到每個(gè)點(diǎn)上老厌,所以每一個(gè)名詞都使用專業(yè)名稱來表示,全篇PRD專業(yè)名稱橫飛黎炉。由于昨天寫的文檔是屬于純邏輯性的文檔枝秤,所以大量在專業(yè)名稱充斥的情況下,整篇文章的可讀性極差慷嗜。

專業(yè)名稱使用注意:

  1. 同一句話中淀弹,能使用代詞來代指句子中的專業(yè)名稱的時(shí)候丹壕,盡量使用代詞表示,因?yàn)榇~更口語化薇溃,也更容易讓人理解菌赖。
  1. 如果使用代詞會(huì)讓整句話產(chǎn)生歧義,那就一定不要使用代詞沐序;
  2. 使用代詞可以增加可讀性琉用,使用專業(yè)名稱可以增加準(zhǔn)確性,所以只有在恰到好處的地方進(jìn)行敲到好處的表達(dá)策幼,才能把文檔的易讀性和準(zhǔn)確性最大化邑时。
緩慢爬坑中....

第三坑——行文邏輯不清晰

在寫開發(fā)文檔的時(shí)候,憑著直覺來寫文檔特姐,在寫之前并沒有梳理清楚其中的邏輯晶丘,以至于最后寫出來地文檔邏輯混亂,各個(gè)板塊互相穿插唐含。

在撰寫文檔前浅浮,首先自己要清楚整個(gè)功能的流程,這個(gè)肯定是毋庸置疑的觉壶。但是脑题,我們?cè)趯懳臋n的時(shí)候,可能就沒有這么在意行文的邏輯铜靶,全憑自覺來撰寫叔遂。

所以在寫文檔的時(shí)候,不僅僅需要理清整個(gè)產(chǎn)品争剿、功能的邏輯已艰,還需要為整篇文章的結(jié)構(gòu)和行為邏輯進(jìn)行提前的思考,不然產(chǎn)出的文檔可讀性也很差蚕苇。

第四坑——詳細(xì)得臃腫

在寫PRD時(shí)哩掺,為了想一次性把問題說清楚,讓程序員能一次性把文檔理解透涩笤。所以會(huì)把一個(gè)問題解釋得很詳細(xì)嚼吞,從而使得文檔變得很臃腫。

這不是認(rèn)真蹬碧,這其實(shí)是一種懶惰舱禽,因?yàn)橄胗梦臋n砸給程序員,讓他們自己去理解產(chǎn)品恩沽,不想和程序員進(jìn)行過多的交流和文檔解釋誊稚。

其實(shí)在實(shí)際工作中,我發(fā)現(xiàn)有就算你寫得再詳細(xì),如果不進(jìn)行口頭介紹里伯,程序員想把如此臃腫的文檔理解清楚也非常不容易城瞎。所以,如果能用流程圖來表述疾瓮,就不需要長(zhǎng)篇累述脖镀;如果能先進(jìn)行產(chǎn)品大致的介紹,讓大家先理解整個(gè)思路爷贫,就不需要文字上過于累贅的表述认然。

產(chǎn)品文檔應(yīng)該做到“考慮全面,邏輯清晰漫萄,語言精練”

第五坑——文檔排版不易讀

原來才開始寫文檔的時(shí)候,完全不知道什么排版盈匾,在無數(shù)次打磨自己的格式后腾务,開始對(duì)排版有了一點(diǎn)自己的理解。

如果說排版有什么技巧削饵,我想可能是這幾個(gè):

  1. 以功能劃分大板塊岩瘦,大板塊標(biāo)題醒目
  1. 把大板塊簡(jiǎn)單拆分窿撬,并用小標(biāo)題區(qū)分启昧。
  2. 用點(diǎn)號(hào)羅列觀點(diǎn),不要寫成一大段劈伴。

對(duì)于文檔排版密末,統(tǒng)一文字格式后,做好以上幾點(diǎn)就能確保文檔基本整潔和可讀性跛璧。但是排版是個(gè)長(zhǎng)期打磨和鍛煉的事情严里,必須要經(jīng)常鍛煉,才能有一套自己的合理的排版風(fēng)格追城。

第六坑——重點(diǎn)內(nèi)容不突出

重點(diǎn)加得非常隨意刹碾,就會(huì)造成兩個(gè)結(jié)果,重點(diǎn)不突出和重點(diǎn)不夠重點(diǎn)座柱。
所以迷帜,文檔中應(yīng)該標(biāo)記重點(diǎn),但也要注意:

  1. 重點(diǎn)最好為重要的動(dòng)詞色洞、轉(zhuǎn)折詞戏锹、新名詞和關(guān)鍵邏輯判定詞等。
  1. 重點(diǎn)內(nèi)容不在于多锋玲,更在于精景用,滿篇重點(diǎn)則是沒有重點(diǎn)。

第七坑——不用程序員喜歡的形式寫文檔

最后,特別重要的一點(diǎn)伞插,也是不可不說的一點(diǎn)割粮,那就是使用程序員容易理解的、喜歡的方式來寫文檔媚污。

  1. 程序員更喜歡看到能用公式來展現(xiàn)各個(gè)數(shù)據(jù)或者信息之間的關(guān)系舀瓢;
  1. 了解程序員編程的時(shí)候常用的邏輯,多以這種邏輯術(shù)語來寫文檔耗美,這樣程序員就更能理解京髓;
  2. 多用分句,別用連句商架,一個(gè)分句表達(dá)一個(gè)意思就可以了堰怨。
  3. 能用配流程圖的,千萬別只寫文字蛇摸。

我是譚宇恒备图。
堅(jiān)持在路上的產(chǎn)品狗,愿陪你一同成長(zhǎng)赶袄。
如果你還有什么產(chǎn)品思考和學(xué)習(xí)經(jīng)驗(yàn)揽涮,請(qǐng)留言與我分享。

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末饿肺,一起剝皮案震驚了整個(gè)濱河市蒋困,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌敬辣,老刑警劉巖雪标,帶你破解...
    沈念sama閱讀 211,123評(píng)論 6 490
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場(chǎng)離奇詭異购岗,居然都是意外死亡汰聋,警方通過查閱死者的電腦和手機(jī),發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 90,031評(píng)論 2 384
  • 文/潘曉璐 我一進(jìn)店門喊积,熙熙樓的掌柜王于貴愁眉苦臉地迎上來烹困,“玉大人,你說我怎么就攤上這事乾吻∷杳罚” “怎么了?”我有些...
    開封第一講書人閱讀 156,723評(píng)論 0 345
  • 文/不壞的土叔 我叫張陵,是天一觀的道長(zhǎng)。 經(jīng)常有香客問我邑狸,道長(zhǎng),這世上最難降的妖魔是什么奢方? 我笑而不...
    開封第一講書人閱讀 56,357評(píng)論 1 283
  • 正文 為了忘掉前任,我火速辦了婚禮蟋字,結(jié)果婚禮上稿蹲,老公的妹妹穿的比我還像新娘。我一直安慰自己鹊奖,他們只是感情好苛聘,可當(dāng)我...
    茶點(diǎn)故事閱讀 65,412評(píng)論 5 384
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著忠聚,像睡著了一般设哗。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上两蟀,一...
    開封第一講書人閱讀 49,760評(píng)論 1 289
  • 那天网梢,我揣著相機(jī)與錄音,去河邊找鬼垫竞。 笑死澎粟,一個(gè)胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的欢瞪。 我是一名探鬼主播,決...
    沈念sama閱讀 38,904評(píng)論 3 405
  • 文/蒼蘭香墨 我猛地睜開眼徐裸,長(zhǎng)吁一口氣:“原來是場(chǎng)噩夢(mèng)啊……” “哼遣鼓!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起重贺,我...
    開封第一講書人閱讀 37,672評(píng)論 0 266
  • 序言:老撾萬榮一對(duì)情侶失蹤骑祟,失蹤者是張志新(化名)和其女友劉穎,沒想到半個(gè)月后气笙,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體次企,經(jīng)...
    沈念sama閱讀 44,118評(píng)論 1 303
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 36,456評(píng)論 2 325
  • 正文 我和宋清朗相戀三年潜圃,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了缸棵。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 38,599評(píng)論 1 340
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡谭期,死狀恐怖堵第,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情隧出,我是刑警寧澤踏志,帶...
    沈念sama閱讀 34,264評(píng)論 4 328
  • 正文 年R本政府宣布,位于F島的核電站胀瞪,受9級(jí)特大地震影響针余,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 39,857評(píng)論 3 312
  • 文/蒙蒙 一圆雁、第九天 我趴在偏房一處隱蔽的房頂上張望忍级。 院中可真熱鬧,春花似錦摸柄、人聲如沸颤练。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,731評(píng)論 0 21
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)嗦玖。三九已至,卻和暖如春跃脊,著一層夾襖步出監(jiān)牢的瞬間宇挫,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 31,956評(píng)論 1 264
  • 我被黑心中介騙來泰國(guó)打工酪术, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留器瘪,地道東北人。 一個(gè)月前我還...
    沈念sama閱讀 46,286評(píng)論 2 360
  • 正文 我出身青樓绘雁,卻偏偏與公主長(zhǎng)得像橡疼,于是被迫代替她去往敵國(guó)和親。 傳聞我的和親對(duì)象是個(gè)殘疾皇子庐舟,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 43,465評(píng)論 2 348

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