產(chǎn)品經(jīng)理作為第一批感知“春江水暖”的崗位，對市場的變化和需求尤為敏感。

隨著市場的規(guī)范和成熟，B端產(chǎn)品需求不斷上升，競爭變得日益激烈。特別是在企業(yè)大規(guī)模進(jìn)軍建立全球業(yè)務(wù)時，產(chǎn)品經(jīng)理的基本功——產(chǎn)品文檔的重要性不斷增加。

面對這樣的變化，以往的經(jīng)驗不再百試百靈，B端產(chǎn)品技術(shù)文檔的核心發(fā)生改變。不少產(chǎn)品經(jīng)理反饋他們在工作中經(jīng)常會遇到以下問題：

1. 什么樣的產(chǎn)品文檔才是用戶更感興趣的，更容易理解的？
2. 產(chǎn)品文檔怎樣寫才能提高我們的業(yè)務(wù)效率？
3. B端產(chǎn)品技術(shù)文檔在撰寫時，如何進(jìn)行內(nèi)容思維的升級？
4. 面向海外市場，如何構(gòu)建一個多語言文檔系統(tǒng)？

為了幫助更多產(chǎn)品人系統(tǒng)構(gòu)建B端產(chǎn)品文檔思維，切實地提高產(chǎn)品文檔質(zhì)量，人人都是產(chǎn)品經(jīng)理聯(lián)合 RWS 舉辦了2023年特別企劃活動。

4月19日，本場活動我們邀請到了字節(jié)跳動文檔工程師@楊鶴 、RWS 語言服務(wù)和技術(shù)事業(yè)部中國區(qū)首席咨詢顧問@呼延韶文 2 位嘉賓，從用戶、產(chǎn)品文檔、模型及固件等方面與大家討論怎樣升級文檔技能，以實現(xiàn)產(chǎn)品價值提升。

01 產(chǎn)品文檔的結(jié)構(gòu)化設(shè)計

楊鶴：字節(jié)跳動文檔工程師。負(fù)責(zé)火山引擎toB的產(chǎn)品文檔，飛書開放平臺和PICO開發(fā)者文檔的建設(shè)。在軟件產(chǎn)品文檔開發(fā)、文檔質(zhì)量管控和信息架構(gòu)搭建領(lǐng)域擁有豐富經(jīng)驗。

分享伊始，楊鶴老師先是再次強(qiáng)調(diào)了產(chǎn)品文檔的重要性，它貫穿于整個用戶旅程，也在各個產(chǎn)品中隨處可見。如果產(chǎn)品文檔寫得不夠準(zhǔn)確，會給用戶帶來不好的使用感受，進(jìn)而影響業(yè)務(wù)。

那么如何寫好產(chǎn)品文檔呢？楊鶴老師認(rèn)為我們要具備結(jié)構(gòu)化思維。

主流的結(jié)構(gòu)化寫法分為三種：Information Mapping、Topic-Based Writing、Every Page is Page One。這三種寫法各有利弊，目前使用最為廣泛的是后兩種。

楊鶴老師對這三種結(jié)構(gòu)化寫法一一展開介紹，并用案例輔助理解它們是如何應(yīng)用在實際的文檔寫作中的。

接著，她提出一個內(nèi)容編寫的方法：金字塔原理結(jié)論先行，突出重點。即確定核心信息、創(chuàng)建主要觀點、組織主要觀點、添加支持細(xì)節(jié)、清晰的標(biāo)題和子標(biāo)題。

這個金字塔原理要怎樣應(yīng)用在文檔中呢？不如去直播中一探究竟吧：https://996.pm/YyXPx

02 激活產(chǎn)品文檔的業(yè)務(wù)價值

呼延韶文：RWS 語言服務(wù)和技術(shù)事業(yè)部中國區(qū)首席咨詢顧問。專注企業(yè)內(nèi)容管理領(lǐng)域近20年，曾就職于BM、EMC、OpenText等公司的企業(yè)內(nèi)容管理部門。為華為、小米等國內(nèi)領(lǐng)先企業(yè)提供內(nèi)容管理戰(zhàn)略咨詢。

產(chǎn)品文檔作為產(chǎn)品經(jīng)理和用戶溝通的媒介，在如今數(shù)字化的環(huán)境下，它在創(chuàng)作、管理、交付上都出現(xiàn)了很多問題，例如：

1. 沒有統(tǒng)一的協(xié)同創(chuàng)作界面和工具
2. 內(nèi)容之間的聯(lián)系錯綜復(fù)雜，管理難度大
3. 缺乏數(shù)字化交付能力，內(nèi)容多以靜態(tài)文檔包形式交付
4. 很難做到個性化的內(nèi)容交付
5. ……

在企業(yè)出海過程中，一個產(chǎn)品往往存在多個型號、多個版本、多個語種、多個動態(tài)交付，幾何乘積效應(yīng)增加了內(nèi)容管理和交付的復(fù)雜度。

面對這樣的挑戰(zhàn)，結(jié)構(gòu)化的寫作和管理方式是解決問題的關(guān)鍵。

通過結(jié)構(gòu)化的管理方式，可以提高內(nèi)容的質(zhì)量，實現(xiàn)內(nèi)容重用，提升用戶體驗等。并且，給企業(yè)帶來明顯的業(yè)務(wù)價值：提升產(chǎn)品銷量，提高客戶滿意度，提升品牌忠誠度。

并且，通過結(jié)構(gòu)化創(chuàng)作和動態(tài)發(fā)布可以滿足當(dāng)下和未來的用戶需求。

用戶希望以自己喜歡的方式，在需要的時候獲取最相關(guān)的內(nèi)容。而產(chǎn)品經(jīng)理需要做的是，以解決用戶需求為出發(fā)點的內(nèi)容數(shù)字化動態(tài)發(fā)布。

還有更多的內(nèi)容因為篇幅有限不全部展開啦，感興趣的同學(xué)戳鏈接進(jìn)行觀看：https://996.pm/YyXPx

03 圓桌互動問答

兩位老師的分享結(jié)束，在場的聽眾紛紛提出自己的疑問，希望得到老師們的解答。一起來看看有哪些精彩的對話吧。

Q1：產(chǎn)品經(jīng)理在寫文檔的時候需要注意什么？容易陷入什么誤區(qū)？

1）產(chǎn)品經(jīng)理的文檔通常會從產(chǎn)品功能的角度出發(fā)，而忽略了用戶場景。

例如，有一個產(chǎn)品功能是讓用戶聯(lián)網(wǎng)，但文檔卻描述了創(chuàng)建網(wǎng)絡(luò)網(wǎng)關(guān)等術(shù)語，對于沒有網(wǎng)絡(luò)背景知識的用戶來說這是不容易理解的。

2）使用過多的術(shù)語，或是對概念進(jìn)行了過度的包裝，使用戶很難聯(lián)系起來。

比如，通訊錄、組織機(jī)構(gòu)、成員等概念在文檔中可能會難以理解。

3）文檔信息的缺失。

由于產(chǎn)品經(jīng)理已經(jīng)非常熟悉我們的產(chǎn)品，可能會忽略一些用戶可能不知道的背景信息，同時缺少關(guān)注點提示，直接引導(dǎo)用戶到達(dá)某一個操作步驟。

Q2：出海產(chǎn)品在文檔的寫作方式和工具選擇上需要注意什么？

很巧合的是，我前兩天出差訪問了一家主要做海外市場的企業(yè)。因為客戶群主要在海外，所以他們在產(chǎn)品文檔撰寫、翻譯和多語言發(fā)布方面積累了很多經(jīng)驗，同時也經(jīng)歷了不少痛苦。

建議產(chǎn)品經(jīng)理和文檔專家在規(guī)劃自己的產(chǎn)品和文檔時，即使短期內(nèi)產(chǎn)品還不具備出海條件，但只要不排除未來會拓展海外市場的可能性，就可以在整個產(chǎn)品和文檔規(guī)劃中，提前進(jìn)行規(guī)劃，看看是否適合采用結(jié)構(gòu)化的創(chuàng)作方式。

該客戶在進(jìn)行內(nèi)容出海的多語種轉(zhuǎn)換時用到了XML的創(chuàng)作方式，對內(nèi)容進(jìn)行標(biāo)記。此外，數(shù)據(jù)庫、翻譯記憶庫、翻譯流程自動化、不同翻譯資源對接等因素，也是在構(gòu)建內(nèi)容創(chuàng)作平臺方面非常有益的考慮因素。

因此，建議產(chǎn)品經(jīng)理和文檔專家們從這些方面進(jìn)行布局和考慮。

Q3：現(xiàn)在為了追求更高效、長壽命地使用產(chǎn)品，越來越多的技術(shù)文檔貫徹了極簡主義，但是經(jīng)常本末倒置，用戶沒辦法閱讀。怎樣看待這一現(xiàn)象？

若用戶不能有效閱讀，這可能是因為內(nèi)容出現(xiàn)了過度的極簡主義，即不是說越少內(nèi)容越好，而是要去除多余信息，將關(guān)鍵點凸顯。在貫徹實踐極簡主義時，需要在完整性和內(nèi)容間達(dá)到平衡。

例如，可以刪去不必要的修飾語和重復(fù)表達(dá)，避免使用過于專業(yè)難懂的術(shù)語，可以使用通用詞匯，使示例清晰化并注重圖表的表達(dá)。

強(qiáng)調(diào)的應(yīng)該是在表達(dá)上的精煉，而不是減少內(nèi)容量，避免刪除必要的信息，因為那會使用戶難以理解。

Q4：有沒有好用的工具或者小技巧，可以提升產(chǎn)品文檔的寫作效率？

我非常贊同使用專業(yè)工具來做專業(yè)的事。不過，隨著時代不斷變遷，無論是工具、平臺還是方法論都需要不斷發(fā)展。

例如，10年前我們?nèi)粘Ｐ枰∷嫖臋n的輸出，此時InDesign是最專業(yè)的工具。然而現(xiàn)在，隨著數(shù)字化出版的大量應(yīng)用，InDesign有可能限制輸出效率。因此，這些不同工具都是相對的。

在數(shù)字出版的時代，我認(rèn)為楊鶴老師所提到的結(jié)構(gòu)化創(chuàng)作方式能更高效、符合產(chǎn)品內(nèi)容創(chuàng)作的要求。

這個結(jié)構(gòu)化的創(chuàng)作方式主要有兩種，其中一種非常流行。擁有專業(yè)的結(jié)構(gòu)化內(nèi)容創(chuàng)作團(tuán)隊，對于此類應(yīng)用場景，他們更需要專業(yè)且高效的XML編輯器等專業(yè)編輯器。

另一種場景是許多非文檔專業(yè)人士參與產(chǎn)品內(nèi)容的創(chuàng)作，讓他們使用專業(yè)的XML創(chuàng)作工具往往不合適。針對這些人，需要一種簡單易用但又具有結(jié)構(gòu)化協(xié)同特點的編輯環(huán)境。

這兩種場景通常在企業(yè)文檔管理中同時存在，因此我們需要綜合考慮這個問題。

還有更多有趣精彩的問答，可以在直播當(dāng)中一睹為快：https://996.pm/YyXPx 。同時，對內(nèi)容管理感興趣的同學(xué)，也可以掃描下方二維碼，關(guān)注RWS官方公眾號，了解到更多行業(yè)資訊。