最近在帶一位應屆生,他讓我對文檔寫作有了一些新的體會,正好和過去的積累串起來講講。
我寫文檔有兩個特點:簡潔、清晰。
簡潔:一句話能說清的,絕不用第二句,且用最簡單的句子。
清晰:結構清晰,讓人一目了然;邏輯清晰,盡量降低讀者的理解成本;重點清晰。
對上級。上級的時間寶貴,建議用「金字塔原理」(《金字塔原理》值得一讀):開頭先給結論——分析結果、方案概述,再展開細節與理由。
對下級。多為執行層面,要強調目的、完成時間、負責人、驗收標準、注意事項。
跨部門。多為需求類文檔,要說清需求目的、實現細節、測試時間、上線時間。
以活動策劃為例,對外文檔主要就是活動公告,這是我想重點說的部分。
【結構】
活動標題、活動引言、活動時間、活動範圍、活動獎勵、活動內容、活動說明。這幾塊缺一不可,順序沒有定式,保持前後一致即可。既然多數公告都用這個結構,那麼做一個模板是很有必要的,能省下大量時間。
【重點】
語言簡潔不說廢話,同時突出重點。凡是與玩家參與相關的都是重點(5W1H),盡量用顏色區分,但顏色不宜超過三種,多了反而難看。我一般在獎勵(紅色)和 NPC(藍色)上做區分,時間因為獨立成段就不必上色。
【邏輯】
大部分活動邏輯並不複雜——如果多數活動的邏輯都很複雜,那說明策劃本身失敗了,方案「攔住了」大量玩家。這時沿用上面的結構就好。
但有時候因為某些功能暫時無法實現,或為了增加趣味,我們會設計更複雜的流程。此時再套那個結構就不明智了:寫完讓一位不了解活動的同事看,他大概率會告訴你兩件事——第一不願意看,字太多;第二看不懂,因為「活動內容」和「活動說明」兩段的邏輯交織在一起。
面對複雜活動,我建議改用玩家的行為邏輯來組織,目的始終是讓玩家知道「我要做什麼」。
活動概述:用最簡潔的語言說明核心內容、獎勵與參與範圍(同樣是金字塔原理)。
流程圖:用圖形降低理解成本。圖中只保留玩家行為,若流程裡夾著官方人員的工作內容,去掉它。
流程詳情:每一步都包含時間、內容、其他說明。

【修飾】
加入獎勵圖片:把獎勵文字標紅,遠不如直接放獎勵圖示。
加入貼合主題的圖片:這類圖是用來傳遞情緒的,比如母親節活動配一張體現親情的圖,感染力會更強。
活動引言:以前我最不愛寫這段,現在覺得它很重要,因為它體現了一種風格,就像人的個性。三國題材的遊戲,引言裡化用一些典故就很合適。
不要迷信圖片一定優於文字:我曾經篤信這一點,一度在所有公告裡都加流程圖(包括邏輯很簡單的活動),結果發現圖片很難精確表達細節,反而容易誤導。所以簡單活動別用圖,複雜活動再加流程圖。
【當局者迷】
方案是我們自己想的,整套邏輯在我們腦中天然成立,不存在理解障礙。同時,我們只設計了預期中的玩家行為,其他路徑容易被忽略。基於這兩點,寫完的文檔很可能讓玩家困惑。
所以寫完之後,最好找一位不了解該方案的同事試讀,看是否存在理解障礙,或者哪些地方玩家可能鑽空子。聽取局外人的意見做最終修訂,這樣的文檔才是玩家喜歡的,而不是只有我們自己喜歡。