?五千字總結(jié)【文檔規(guī)范】的基礎(chǔ)要求

1 評論 11444 瀏覽 40 收藏 22 分鐘
🔗 产品经理在不同的职业阶段,需要侧重不同的方面,从基础技能、业务深度、专业领域到战略规划和管理能力。

文檔是我們工作中最基礎(chǔ)的一部分,但是這些產(chǎn)出物真的合格嗎?如果我們想提升文檔能力,可以采用哪些“拿來即用”的簡單方法?本文分享了一些基礎(chǔ)的規(guī)范和注意事項(xiàng),希望能對你有點(diǎn)幫助。

“故不積跬步,無以至千里”,成長如此,文檔亦是如此。當(dāng)我們把一個個小細(xì)節(jié)處理好之后,最終呈現(xiàn)的效果一定會不一樣。

早在今年七月份,就想給同事培訓(xùn)一下關(guān)于寫文檔中需要注意的基礎(chǔ)要求、基礎(chǔ)規(guī)范。但是因?yàn)榉N種原因一直拖延到現(xiàn)在,我決定把這些內(nèi)容整理成文字分享出來,希望每位同行都能夠重視文檔的基本規(guī)范,不要因?yàn)橐粫r的疏忽而造成不必要的負(fù)面影響。

文檔本身是產(chǎn)品經(jīng)理日常工作中最基礎(chǔ)的一部分,我們幾乎每天都在寫文檔,但是這些產(chǎn)出物真的合格嗎?如果我們想提升文檔能力,可以采用哪些“拿來即用”的簡單方法?

今天我便以自己這些年在寫文檔中(以word為主)踩過的坑,以及在工作中總結(jié)出的技巧逐一介紹。

全文概覽:

  1. 明確文檔的重要性
  2. 文檔的格式規(guī)范(字體、標(biāo)題、圖片、目錄)
  3. 文檔的內(nèi)容規(guī)范(錯別字、書面語、文件名)
  4. 其他需要注意的細(xì)節(jié)(6條)
  5. 最后的總結(jié)

文章不短,可以先收藏哈~

01 首先,要明確文檔的重要性

提升意識,是做好一件事的前提條件。

我發(fā)現(xiàn)很多文檔寫的不合格,甚至比較爛的同學(xué),在重視程度上就很差。所以最近兩年我在新同事入職培訓(xùn)過程中,第一要務(wù)就是提高大家對文檔產(chǎn)出的重要意識,并通過前期工作的仔細(xì)檢查篩選出常見錯誤,后期自己再寫的時候才能真的注意這些問題。

幸運(yùn)的是通過一年多的努力,還是有所成效。

對于我們?nèi)粘.a(chǎn)出的文檔來說,無論是需求說明書、產(chǎn)品手冊、產(chǎn)品介紹、甚至于一個普通的word匯報(bào)材料,或者項(xiàng)目進(jìn)程中、驗(yàn)收過程中的各項(xiàng)產(chǎn)出物,或者售前過程中的諸多物料,都能客觀反映出一個人、一個團(tuán)隊(duì)、甚至于一家公司的專業(yè)性。

  • 早在幾年前,我就因?yàn)槲臋n中的錯別字導(dǎo)致團(tuán)隊(duì)錯失關(guān)鍵機(jī)會;
  • 還遇到過因?yàn)殄e別字在申請專利時被專利局退稿;
  • 曾因?yàn)楹献鳈C(jī)構(gòu)所提供的文檔經(jīng)常含有錯別字而建議公司更換合作方;
  • 也經(jīng)常遇到在工作中提交的文檔被客戶一頓嫌棄,打回重寫等情況。

所以,如果我們真的只把這些文檔當(dāng)做團(tuán)隊(duì)內(nèi)部的“應(yīng)付材料”,或者覺得反正這么多字,也沒人細(xì)看而長期沒有形成好的規(guī)范習(xí)慣,那后續(xù)會踩到的坑一定不會比我少。

因此,我簡單總結(jié)四點(diǎn)文檔規(guī)范的重要性供大家參考,希望能引起我們真正的重視:

  1. 體現(xiàn)個人、團(tuán)隊(duì)、公司的專業(yè)性,能夠得到對方的認(rèn)可,同時不要因?yàn)檫@些“所謂的小事”被別人挑毛病
  2. 好的文檔能夠提升“可讀性”和“易讀性”,對閱讀者產(chǎn)生良好印象的同時,也能盡量避免錯誤理解,在后續(xù)的工作推進(jìn)中產(chǎn)生不必要的麻煩
  3. 作為客觀的可參照物,真正在雙方扯皮時,文檔是最有利的佐證。而一旦文檔中出現(xiàn)模棱兩可,或者對自身團(tuán)隊(duì)不利的內(nèi)容,前期如果沒發(fā)現(xiàn),后期會不會挖坑那就只能自求多福了。
  4. 最后則是我上文中提到的一些關(guān)鍵性問題,一旦這些材料用于一些重要途徑,便很容易產(chǎn)生重大的負(fù)面影響。

 五千字總結(jié)【文檔規(guī)范】的基礎(chǔ)要求

明確重要性之后,我們便可以正式介紹今天的主題:基礎(chǔ)規(guī)范要求

因?yàn)椴煌男袠I(yè),不同的團(tuán)隊(duì),不同文檔用途,其中的內(nèi)容、格式、結(jié)構(gòu)等等都會有非常大的差異。所以本文不會在這些“變量”中過多介紹,而是從各類文檔都要遵循的基礎(chǔ)規(guī)范來進(jìn)行說明。

02 文檔的格式規(guī)范

這方面大多數(shù)產(chǎn)品同行應(yīng)該都會注意,但很多時候文檔寫多了,我們也會變得“麻木”而忽略一些細(xì)節(jié)。而其他崗位的同事很多就不太注意文檔格式的規(guī)范性,最終的交付物讓人“一言難盡”。

格式規(guī)范性主要包含字體、段落標(biāo)題、段內(nèi)標(biāo)題、圖片、目錄這幾類內(nèi)容。

1. 字體問題

字體最關(guān)鍵是需要全文統(tǒng)一,我們可以按“正文字體”、“小標(biāo)題字體”、“表格內(nèi)字體”、“補(bǔ)充說明字體”、“重點(diǎn)突出字體”來分類,并保證每個類別的全文字體一致。

表格內(nèi)的字體還要考慮字體大小是否會讓表格排序“失真”或“凌亂”,表格的首行標(biāo)題建議加粗、居中。章節(jié)的各級標(biāo)題一定要使用格式刷來統(tǒng)一維護(hù)。

很多文檔不同的段落字體大小、樣式都會有些偏差,究其原因還是作者沒有檢查的意識,也沒有在完成復(fù)制粘貼后順手用格式刷統(tǒng)一的習(xí)慣。

2. 標(biāo)題編號問題

各級標(biāo)題在用格式刷統(tǒng)一的過程中,非常容易出現(xiàn)一些小錯誤。

比如級別錯誤,下圖便是將四級標(biāo)題,誤刷成三級標(biāo)題。

 五千字總結(jié)【文檔規(guī)范】的基礎(chǔ)要求

比如沒有重新開始編號,下圖顯然是將規(guī)則復(fù)制粘貼過來之后,沒有重新編號。

 五千字總結(jié)【文檔規(guī)范】的基礎(chǔ)要求

一個文檔中段落內(nèi)的小標(biāo)題也盡量采用一種格式,比如選擇使用(1)(2)(3),就不要再使用①②③,除非在文檔中有多處不同級別的排序需求再考慮多種小標(biāo)題樣式。

3. 圖片格式問題

文檔中的圖片要居中,如果某個章節(jié)有多張圖片連續(xù),則需要給每個圖片附上文字說明。

而且圖片的大小也需要微調(diào),尤其是一些圖片復(fù)制進(jìn)去之后很大、很模糊,此時把圖片縮小成盡量全文統(tǒng)一的大小則顯得很有必要。

 五千字總結(jié)【文檔規(guī)范】的基礎(chǔ)要求

尤其是一些移動端截圖,復(fù)制到文檔之后可能會“又細(xì)又長”,這時我們一定要隨手調(diào)整大小。

4. 文檔的目錄問題

目錄記得及時更新,我們經(jīng)常遇到內(nèi)容修改之后沒有更新目錄直接提交的情況。

也要記得把目錄的字體、間距調(diào)整到適當(dāng),因?yàn)楹芏嗄J(rèn)的目錄格式說實(shí)話,挺丑的。

 五千字總結(jié)【文檔規(guī)范】的基礎(chǔ)要求

以上這些細(xì)節(jié),都是文檔的格式規(guī)范要求,每一條單獨(dú)來看可能都知道要這樣做,或者也很簡單覺得可以做到,但當(dāng)這些問題匯集到同一個文檔時,就是“閱讀者的災(zāi)難伊始”。

03 文檔的內(nèi)容規(guī)范性

關(guān)于文檔的內(nèi)容,因?yàn)椴煌男袠I(yè)和用途有不同的內(nèi)容要求,本文側(cè)重點(diǎn)不在于內(nèi)容如何整理,而是無論哪種內(nèi)容,我們都需要檢查、規(guī)避的常見問題。

首先,也是我認(rèn)為最最重要的一點(diǎn):錯別字

在智能輸入法普及的今天,我們?nèi)粘5奈淖纸涣髦谐錆M了錯別字,而這些錯別字一旦在產(chǎn)品工作者的產(chǎn)出物中出現(xiàn),會非常影響“印象分”,同時也會被質(zhì)疑此人的細(xì)心、認(rèn)真程度。

大家也都知道出現(xiàn)錯別字不好,但苦于難以察覺,但這并不是我們?nèi)斡慑e別字存在的理由。所以對于錯別字,我有以下幾點(diǎn)建議:

1)換一個相對智能的輸入法

畢竟一個好的輸入法能夠記住我們常用的專業(yè)術(shù)語,能夠在拼寫錯誤時給出智能提示,操作系統(tǒng)默認(rèn)的輸入法很難達(dá)到這個效果。

我曾經(jīng)發(fā)現(xiàn)一位經(jīng)常打錯別字的小伙伴,就是一直在使用mac的默認(rèn)輸入法,換了搜狗之后能降低大約60%的錯字情況。

錯別字很煩銀,比如當(dāng)你讀到這段話的時候,能否一言就看出短短幾十個字里飽含著多少問題呢?我在看新同事寫的文檔時,關(guān)注的第一要素就是有么有矬子和語句不通順的標(biāo)大。

2)在日常生活中多注意

平時打字聊天的時候就養(yǎng)成不打錯字的習(xí)慣,發(fā)出去的內(nèi)容自己再掃一眼,如果出現(xiàn)了錯別字及時改正,我認(rèn)為這是一件很基礎(chǔ)的事情。

但是很多人都不在意,甚至被人多次指出之后也只是呵呵一笑,找個寬慰自己的理由,這些人一定寫不出合格的產(chǎn)品文檔。

3)團(tuán)隊(duì)內(nèi)可采取一些獎懲措施

比如在關(guān)鍵文檔中出現(xiàn)錯別字之后,在團(tuán)隊(duì)內(nèi)部發(fā)紅包,或者當(dāng)你看到其他同學(xué)的文檔有錯別字時及時提醒。

總之一定要采取一些措施,讓大家重視起來,養(yǎng)成日常檢查的習(xí)慣,漸漸地錯別字一定會越來越少。

4)自己一定要通讀幾遍

一個大段落寫完之后,一定要重新讀至少一遍,一方面檢查錯別字,另一方面檢查是否存在語義表達(dá)等問題。

自己要對自己的成果負(fù)責(zé)。

5)可以讓同事幫忙檢查

有時很難發(fā)現(xiàn)自我產(chǎn)生的錯誤,因?yàn)闀萑霊T性思維怪圈。因此找同事幫忙檢查也是不錯的方式。

而且相互幫助,去識別對方的錯誤,也能在很大程度上檢視自己,提升錯字意識。

 五千字總結(jié)【文檔規(guī)范】的基礎(chǔ)要求

以上這些方法都可以快速運(yùn)用,幾乎“0門檻”,逐漸我們會提升錯別字的敏感程度,快速識別錯誤,并且能夠總結(jié)出一些“高頻錯字”。

多管齊下,立竿見影。

其次,在內(nèi)容規(guī)范性上,還有一點(diǎn)很重要:書面語的表達(dá)

雖然經(jīng)過幾百年的發(fā)展,文字表達(dá)從最初的文言文變成了白話文,但白話文也不代表等同于口語化。

我也見到過一些同行在吐槽文檔中為什么一定要用書面語,既費(fèi)時又費(fèi)力。而我個人認(rèn)為原因在于這八個字:正式、規(guī)范、嚴(yán)肅、嚴(yán)謹(jǐn)。

其實(shí)如果是團(tuán)隊(duì)內(nèi)部的文檔,只要領(lǐng)導(dǎo)沒意見,你們愿意怎么搞就怎么搞。一旦涉及到對外輸出,邏輯嚴(yán)謹(jǐn)、表達(dá)清晰、結(jié)構(gòu)明確的內(nèi)容便是基礎(chǔ)。

在此我列舉幾個關(guān)鍵點(diǎn),建議大家在寫文檔時盡量規(guī)避這些問題。

1)表達(dá)簡潔易懂

當(dāng)然,可能有些文檔就是需要復(fù)雜嚴(yán)謹(jǐn)(比如專利申請文檔),讀起來非常拗口但確實(shí)挑不出邏輯漏洞。

不過我們大部分接觸的文檔,還是盡量簡單、易懂,從而讓讀者盡快理解你想表達(dá)的意思

比如:

  • 善于使用邏輯連接詞:“因此”“進(jìn)而”“所以”“反而”“除非”;
  • 簡化短語,將“什么什么的時候”改為“什么什么時”;
  • 復(fù)雜邏輯采用分段、編號、配圖等方式更直接地展現(xiàn)。

2)避免歧義用詞

“一千個人心中有一千個哈姆雷特”,很多詞語都有多面性,當(dāng)使用不恰當(dāng)時,非常容易造成讀者的歧義。

所以我們在使用這些詞語時,要脫離自己的慣性思維,以用戶視角來審視這段話是否準(zhǔn)確。

  • 比如“XX等功能”,這個等字就很微妙。如果是售前類的文檔,“等”沒問題。如果是交付類的文檔,“等”就很容易給后續(xù)的驗(yàn)收挖坑;
  • 比如“單位”這個詞,既可代表計(jì)量單位,又能代表公司、用工單位。當(dāng)然結(jié)合文檔的上下語境能夠體會出其中的含義,但在一段文字內(nèi),如果出現(xiàn)同一個詞代表不同含義的,一定要加以說明,或者換一種表達(dá)形式。
  • 我還在一本書中發(fā)現(xiàn)“資產(chǎn)管理”這個名詞很有歧義。大多數(shù)人會認(rèn)為是辦公資產(chǎn)、固定資產(chǎn)之類的“資產(chǎn)”管理系統(tǒng),而作為金融從業(yè)者,第一反應(yīng)會是“資金類的金融資產(chǎn)”管理系統(tǒng),這兩種系統(tǒng)完全不同。

所以避免內(nèi)容的“二義性”是內(nèi)容規(guī)范中非常重要的一點(diǎn)。3)語義要直接,別讓對方反復(fù)理解

這里和表達(dá)簡潔易懂有幾分類似,但第一條更傾向于別說廢話,此條更傾向于業(yè)務(wù)邏輯盡量直接。

比如:

  • 把雙重否定詞(不得不)改為肯定(就);
  • 把“窮舉”改成“除了”(在條件1、2、3、4、5、6、7、8的情況下,改成除了條件9、10的情況)

最后,關(guān)于內(nèi)容規(guī)范性需要強(qiáng)調(diào)的是:文件命名規(guī)范

文件名一定不能隨便起,尤其是要發(fā)給客戶的文檔。最好能夠通過文件名能讓讀者明白此文檔的目的或核心內(nèi)容。

而且文件名最好能夠和正文內(nèi)的大標(biāo)題保持一致,盡量在文件名中包含客戶的簡稱、版本號、或者修改日期,其中修改日期一般出現(xiàn)在后續(xù)版本修改之后再添加。

比如:

  • 【公司簡稱】產(chǎn)品名稱+用途+版本號
  • 【客戶名稱】+公司簡稱+產(chǎn)品名稱+用途+版本號
  • 產(chǎn)品名稱+用途+日期-備注
  • ……

總之,不要忽略文檔名稱的重要性,如果起一個不專業(yè)的名字,可能對方都不會打開看就駁回了。

 五千字總結(jié)【文檔規(guī)范】的基礎(chǔ)要求

以上便是我對于“內(nèi)容規(guī)范性”的總結(jié),希望我們能給勤加練習(xí),多多注意。

04 其他的注意事項(xiàng)

還有一些其他的注意事項(xiàng),簡單整理供大家參考:

1、我們在寫文檔時,有些沒寫完的內(nèi)容會習(xí)慣性標(biāo)注出來,等到后續(xù)再完善,但此時的標(biāo)注一定要很方便的讓你快速找到。比如采用特定的關(guān)鍵詞(todo、待完善),或者插入批注。

不要僅僅增加一個字體顏色或者背景色來標(biāo)注。因?yàn)槲臋n如果很長、如果沒有逐行檢查,很有可能會遺漏。

2、文檔內(nèi)容如果不是特別多,在多人協(xié)作時盡量使用【修訂模式】,避免協(xié)作過程中出現(xiàn)沖突或疏忽而產(chǎn)生內(nèi)容問題。最終合并時再把修訂內(nèi)容逐一核對,可以避免很多協(xié)同過程的麻煩。

當(dāng)然,如果文檔較長,修訂模式會很卡,多人協(xié)作要么采用一些其他協(xié)同工具,要么做好分工,避免同一部分多人修改的情況。

3、較長的文檔,建議增加頁碼。

4、最好有“版本修訂記錄”,但不是必須。畢竟修改記錄后期維護(hù)起來非常繁瑣。如果文檔版本變動頻繁或者有追溯的必要性時,再增加修訂記錄也可以。

關(guān)于修訂記錄還需要注意一點(diǎn):修訂的內(nèi)容是否適合讓接收人看到?至于為什么,你可以細(xì)品一下,我就不多說了

5、從其他文檔復(fù)制進(jìn)來的內(nèi)容,一定要進(jìn)行關(guān)鍵詞檢索。可以日常維護(hù)一個“關(guān)鍵詞詞庫”,包含其他客戶的名稱、其他產(chǎn)品的名稱、以及易錯的關(guān)鍵詞。待文檔完成后,進(jìn)行全局檢索,大概率會有“驚喜”。

6、客戶給的模板,盡量不要在結(jié)構(gòu)上大改。有些章節(jié)如果沒有內(nèi)容,或者不知道怎么寫,可以標(biāo)注“不適用”。但是如果你直接把章節(jié)刪掉,后續(xù)交付、審核時可能會被糾錯。當(dāng)然,刪掉的前提也要和客戶溝通清楚。

 五千字總結(jié)【文檔規(guī)范】的基礎(chǔ)要求

以上,就是今天所有的分享,不知道你看完之后有沒有發(fā)現(xiàn)自己之前的小問題呢?

如果有,那就快去改吧。如果沒有,那么恭喜你,你的文檔能力已經(jīng)超越了大多數(shù)產(chǎn)品同行,繼續(xù)加油吧。

05 寫在最后

“故不積跬步,無以至千里”,成長如此,文檔亦是如此。當(dāng)我們把一個個小細(xì)節(jié)處理好之后,最終呈現(xiàn)的效果一定會不一樣。

我始終記得早些年因?yàn)槲臋n疏忽而踩過的坑、熬過的夜、被駁回的記錄,那一個個痛苦且煩悶的日子讓我逐漸意識到文檔的重要性。

我也記得身邊的幾位小伙伴在被我找出很多文檔基礎(chǔ)性問題時的無助與無奈。但好在,當(dāng)我們真的開始注意這些問題時,一切都在向著更好的方向改變。

最后,正式、規(guī)范、嚴(yán)肅、嚴(yán)謹(jǐn),不僅體現(xiàn)在文檔上,更應(yīng)該體現(xiàn)在日常的工作中。

專欄作家

不想延期,公眾號:不想延期,人人都是產(chǎn)品經(jīng)理專欄作家。半路轉(zhuǎn)行的B端泛金融產(chǎn)品,堅(jiān)持“以實(shí)踐驗(yàn)證理論,以輸出倒逼成長”的目標(biāo)。點(diǎn)滴珍貴,重在積累

本文原創(chuàng)發(fā)布于人人都是產(chǎn)品經(jīng)理,未經(jīng)許可,禁止轉(zhuǎn)載。

題圖來自 Unsplash,基于CC0協(xié)議。

該文觀點(diǎn)僅代表作者本人,人人都是產(chǎn)品經(jīng)理平臺僅提供信息存儲空間服務(wù)。

更多精彩內(nèi)容,請關(guān)注人人都是產(chǎn)品經(jīng)理微信公眾號或下載App
評論
評論請登錄
  1. 學(xué)到了,謝謝分享

    來自天津 回復(fù)
专题
16991人已学习12篇文章
如何搞懂财务和业务之间的关系,并推进业务系统财务模块的建设呢?本专题的文章分享了财务系统的设计指南。
专题
61045人已学习12篇文章
业务流程图是最常见的图表之一,能看懂读懂是必修课,能绘制便是非常重要的选修课。
专题
14504人已学习13篇文章
作为一名运营,需要持续对自己的经验进行总结并不断更新迭代。本专题的文章分享了运营方法论。
专题
126021人已学习33篇文章
小程序时代,产品经理和运营人员该如何拥抱这种变化?
专题
37740人已学习22篇文章
复盘是产品经理和运营人提高自身竞争力的不二法门。