?五千字總結【文檔規范】的基礎要求

1 評論 11121 瀏覽 40 收藏 22 分鐘

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

“故不積跬步,無以至千里”,成長如此,文檔亦是如此。當我們把一個個小細節處理好之后,最終呈現的效果一定會不一樣。

早在今年七月份,就想給同事培訓一下關于寫文檔中需要注意的基礎要求、基礎規范。但是因為種種原因一直拖延到現在,我決定把這些內容整理成文字分享出來,希望每位同行都能夠重視文檔的基本規范,不要因為一時的疏忽而造成不必要的負面影響。

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

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

全文概覽:

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

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

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

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

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

幸運的是通過一年多的努力,還是有所成效。

對于我們日常產出的文檔來說,無論是需求說明書、產品手冊、產品介紹、甚至于一個普通的word匯報材料,或者項目進程中、驗收過程中的各項產出物,或者售前過程中的諸多物料,都能客觀反映出一個人、一個團隊、甚至于一家公司的專業性。

  • 早在幾年前,我就因為文檔中的錯別字導致團隊錯失關鍵機會;
  • 還遇到過因為錯別字在申請專利時被專利局退稿;
  • 曾因為合作機構所提供的文檔經常含有錯別字而建議公司更換合作方;
  • 也經常遇到在工作中提交的文檔被客戶一頓嫌棄,打回重寫等情況。

所以,如果我們真的只把這些文檔當做團隊內部的“應付材料”,或者覺得反正這么多字,也沒人細看而長期沒有形成好的規范習慣,那后續會踩到的坑一定不會比我少。

因此,我簡單總結四點文檔規范的重要性供大家參考,希望能引起我們真正的重視:

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

 五千字總結【文檔規范】的基礎要求

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

因為不同的行業,不同的團隊,不同文檔用途,其中的內容、格式、結構等等都會有非常大的差異。所以本文不會在這些“變量”中過多介紹,而是從各類文檔都要遵循的基礎規范來進行說明。

02 文檔的格式規范

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

格式規范性主要包含字體、段落標題、段內標題、圖片、目錄這幾類內容。

1. 字體問題

字體最關鍵是需要全文統一,我們可以按“正文字體”、“小標題字體”、“表格內字體”、“補充說明字體”、“重點突出字體”來分類,并保證每個類別的全文字體一致。

表格內的字體還要考慮字體大小是否會讓表格排序“失真”或“凌亂”,表格的首行標題建議加粗、居中。章節的各級標題一定要使用格式刷來統一維護。

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

2. 標題編號問題

各級標題在用格式刷統一的過程中,非常容易出現一些小錯誤。

比如級別錯誤,下圖便是將四級標題,誤刷成三級標題。

 五千字總結【文檔規范】的基礎要求

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

 五千字總結【文檔規范】的基礎要求

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

3. 圖片格式問題

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

而且圖片的大小也需要微調,尤其是一些圖片復制進去之后很大、很模糊,此時把圖片縮小成盡量全文統一的大小則顯得很有必要。

 五千字總結【文檔規范】的基礎要求

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

4. 文檔的目錄問題

目錄記得及時更新,我們經常遇到內容修改之后沒有更新目錄直接提交的情況。

也要記得把目錄的字體、間距調整到適當,因為很多默認的目錄格式說實話,挺丑的。

 五千字總結【文檔規范】的基礎要求

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

03 文檔的內容規范性

關于文檔的內容,因為不同的行業和用途有不同的內容要求,本文側重點不在于內容如何整理,而是無論哪種內容,我們都需要檢查、規避的常見問題。

首先,也是我認為最最重要的一點:錯別字

在智能輸入法普及的今天,我們日常的文字交流中充滿了錯別字,而這些錯別字一旦在產品工作者的產出物中出現,會非常影響“印象分”,同時也會被質疑此人的細心、認真程度。

大家也都知道出現錯別字不好,但苦于難以察覺,但這并不是我們任由錯別字存在的理由。所以對于錯別字,我有以下幾點建議:

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

畢竟一個好的輸入法能夠記住我們常用的專業術語,能夠在拼寫錯誤時給出智能提示,操作系統默認的輸入法很難達到這個效果。

我曾經發現一位經常打錯別字的小伙伴,就是一直在使用mac的默認輸入法,換了搜狗之后能降低大約60%的錯字情況。

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

2)在日常生活中多注意

平時打字聊天的時候就養成不打錯字的習慣,發出去的內容自己再掃一眼,如果出現了錯別字及時改正,我認為這是一件很基礎的事情。

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

3)團隊內可采取一些獎懲措施

比如在關鍵文檔中出現錯別字之后,在團隊內部發紅包,或者當你看到其他同學的文檔有錯別字時及時提醒。

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

4)自己一定要通讀幾遍

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

自己要對自己的成果負責。

5)可以讓同事幫忙檢查

有時很難發現自我產生的錯誤,因為會陷入慣性思維怪圈。因此找同事幫忙檢查也是不錯的方式。

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

 五千字總結【文檔規范】的基礎要求

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

多管齊下,立竿見影。

其次,在內容規范性上,還有一點很重要:書面語的表達

雖然經過幾百年的發展,文字表達從最初的文言文變成了白話文,但白話文也不代表等同于口語化。

我也見到過一些同行在吐槽文檔中為什么一定要用書面語,既費時又費力。而我個人認為原因在于這八個字:正式、規范、嚴肅、嚴謹。

其實如果是團隊內部的文檔,只要領導沒意見,你們愿意怎么搞就怎么搞。一旦涉及到對外輸出,邏輯嚴謹、表達清晰、結構明確的內容便是基礎。

在此我列舉幾個關鍵點,建議大家在寫文檔時盡量規避這些問題。

1)表達簡潔易懂

當然,可能有些文檔就是需要復雜嚴謹(比如專利申請文檔),讀起來非常拗口但確實挑不出邏輯漏洞。

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

比如:

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

2)避免歧義用詞

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

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

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

所以避免內容的“二義性”是內容規范中非常重要的一點。3)語義要直接,別讓對方反復理解

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

比如:

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

最后,關于內容規范性需要強調的是:文件命名規范

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

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

比如:

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

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

 五千字總結【文檔規范】的基礎要求

以上便是我對于“內容規范性”的總結,希望我們能給勤加練習,多多注意。

04 其他的注意事項

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

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

不要僅僅增加一個字體顏色或者背景色來標注。因為文檔如果很長、如果沒有逐行檢查,很有可能會遺漏。

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

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

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

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

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

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

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

 五千字總結【文檔規范】的基礎要求

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

如果有,那就快去改吧。如果沒有,那么恭喜你,你的文檔能力已經超越了大多數產品同行,繼續加油吧。

05 寫在最后

“故不積跬步,無以至千里”,成長如此,文檔亦是如此。當我們把一個個小細節處理好之后,最終呈現的效果一定會不一樣。

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

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

最后,正式、規范、嚴肅、嚴謹,不僅體現在文檔上,更應該體現在日常的工作中。

專欄作家

不想延期,公眾號:不想延期,人人都是產品經理專欄作家。半路轉行的B端泛金融產品,堅持“以實踐驗證理論,以輸出倒逼成長”的目標。點滴珍貴,重在積累

本文原創發布于人人都是產品經理,未經許可,禁止轉載。

題圖來自 Unsplash,基于CC0協議。

該文觀點僅代表作者本人,人人都是產品經理平臺僅提供信息存儲空間服務。

更多精彩內容,請關注人人都是產品經理微信公眾號或下載App
評論
評論請登錄
  1. 學到了,謝謝分享

    來自天津 回復