互聯(lián)網(wǎng)產(chǎn)品的需求文檔寫(xiě)作，應(yīng)該注意哪些事項(xiàng)和規(guī)范？在編寫(xiě)需求文檔之前，您必須弄清楚要向誰(shuí)顯示它。在寫(xiě)作的過(guò)程中，想象一下彼此分享。過(guò)去，很多人用word，但現(xiàn)在，作為一個(gè)互聯(lián)網(wǎng)人，他們必須使用在線文檔

互聯(lián)網(wǎng)產(chǎn)品的需求文檔寫(xiě)作，應(yīng)該注意哪些事項(xiàng)和規(guī)范？

在編寫(xiě)需求文檔之前，您必須弄清楚要向誰(shuí)顯示它。在寫(xiě)作的過(guò)程中，想象一下彼此分享。

過(guò)去，很多人用word，但現(xiàn)在，作為一個(gè)互聯(lián)網(wǎng)人，他們必須使用在線文檔和各種在線筆記。

一般來(lái)說(shuō)，需求文件不是一次形成的，需要多次評(píng)審會(huì)議反復(fù)修改，因此版本管理尤為重要。

編寫(xiě)文檔是每個(gè)人的習(xí)慣，沒(méi)有必要為一些簡(jiǎn)單的交互說(shuō)明詳細(xì)描述每個(gè)頁(yè)面。因此，有必要在一開(kāi)始就做一個(gè)全局性的描述，在整個(gè)需求文檔中，或者在一些總體功能中，比如“權(quán)限”、“交互指令”等等，都要簡(jiǎn)短。

由于是文件介紹，措辭必須標(biāo)準(zhǔn)化并盡可能詳細(xì)。畢竟，審閱需求文檔的人不是你的胃里的蟲(chóng)子。他不知道你怎么想，所以需要詳細(xì)描述每一頁(yè)的邏輯關(guān)系。

另外，能用圖紙的不要用文字，能放樣圖的盡量通過(guò)樣圖展示。

產(chǎn)品經(jīng)理為什么要寫(xiě)產(chǎn)品需求文檔？

作為產(chǎn)品經(jīng)理，這是非常基礎(chǔ)和重要的工作內(nèi)容之一。同時(shí)，還有其他文檔一起編寫(xiě)供團(tuán)隊(duì)使用，俗稱“產(chǎn)品桶”。

包括：交互式原型草稿、產(chǎn)品需求規(guī)格說(shuō)明文件（PRD）和功能開(kāi)發(fā)清單

我剛開(kāi)始做產(chǎn)品的時(shí)候，我以為只要畫(huà)一個(gè)原型，我會(huì)和你開(kāi)個(gè)會(huì)詳細(xì)討論一下，然后你在會(huì)上開(kāi)發(fā)就不會(huì)有問(wèn)題了，然后開(kāi)發(fā)者就開(kāi)始著手了。因此，你會(huì)發(fā)現(xiàn)，你還是要每天去開(kāi)發(fā)商那里談各種問(wèn)題，進(jìn)入答疑解惑的忙碌過(guò)程。幾乎不可能召開(kāi)會(huì)議來(lái)解釋產(chǎn)品，并期望每個(gè)人在兩三個(gè)小時(shí)內(nèi)記住計(jì)劃產(chǎn)品的所有細(xì)節(jié)。

還可以使研發(fā)人員對(duì)項(xiàng)目背景、期望、產(chǎn)品細(xì)節(jié)有非常清晰的了解，并盡可能列出產(chǎn)品各方面可能存在的問(wèn)題，從而提高開(kāi)發(fā)效率，避免不必要的頻繁溝通。

在開(kāi)始做產(chǎn)品的時(shí)候，我一直認(rèn)為只要原型畫(huà)好了，我們會(huì)開(kāi)會(huì)討論，然后研發(fā)團(tuán)隊(duì)就開(kāi)始著手。因此，你會(huì)發(fā)現(xiàn)，此后的每一天，你都忙于回答問(wèn)題和解決問(wèn)題，因?yàn)槟銕缀醪豢赡苷偌邪l(fā)會(huì)議來(lái)解釋，指望他們?cè)趦扇齻€(gè)小時(shí)內(nèi)記住所有細(xì)節(jié)。有些開(kāi)發(fā)人員覺(jué)得害羞，經(jīng)常抱怨你，直接按照自己的想法去做。然后你坐著等各種土草驗(yàn)收，然后蟲(chóng)子來(lái)?yè)Q吧。

時(shí)間花了，達(dá)不到你想要的效果，你不快樂(lè)，發(fā)展不快樂(lè)。為什么不想想怎么解決呢？在這一點(diǎn)上，珠江三角洲文件的重要性變得顯而易見(jiàn)。

通過(guò)這些文檔，研發(fā)人員可以從宏觀到細(xì)節(jié)清楚地了解產(chǎn)品。

后端開(kāi)發(fā)完接口才給出接口文檔，合理嗎？你怎么看？

一個(gè)非常好的問(wèn)題。我是一個(gè)web應(yīng)用程序架構(gòu)師，多年來(lái)一直致力于回答這個(gè)問(wèn)題。歡迎跟我來(lái)了解更多。

后端提供接口文檔為時(shí)已晚，這是合理和不合理的。根據(jù)具體情況，總有解決辦法。讓我談?wù)勎业挠^點(diǎn)。

不合理：成熟的技術(shù)團(tuán)隊(duì)重視功能設(shè)計(jì)，在編寫(xiě)代碼之前有完整的技術(shù)文檔和功能定義。即使在TDD測(cè)試驅(qū)動(dòng)的開(kāi)發(fā)模式下，測(cè)試數(shù)據(jù)已經(jīng)準(zhǔn)備好了，那么接口邏輯就已經(jīng)確定了接口文檔是否編寫(xiě)好了，理清它們是很自然的。

-第一，主觀原因。原因是多方面的，比如趕進(jìn)度，沒(méi)有時(shí)間，不懶得寫(xiě)，甚至在開(kāi)發(fā)前沒(méi)有仔細(xì)設(shè)計(jì)，在做的時(shí)候也有變化。真的沒(méi)有好辦法。

-客觀原因：需求在變化，功能在變化，接口也在變化。所以，如果你寫(xiě)了一個(gè)文件，它的自然更新和維護(hù)？天哪？

有解決方案嗎？建議嘗試：[1]swagger接口文檔，將文檔集成到代碼中，集成維護(hù)文檔和修改代碼，在修改代碼邏輯的同時(shí)方便修改文檔描述。

2、郵遞員界面測(cè)試工具，導(dǎo)入導(dǎo)出JSON文件，高效的團(tuán)隊(duì)合作。Postman支持各種請(qǐng)求方法和配置環(huán)境變量，對(duì)返回的結(jié)果進(jìn)行測(cè)試和驗(yàn)證，支持批量自動(dòng)操作，可與自動(dòng)構(gòu)建系統(tǒng)集成。