🔎 技術寫作新手攻略大全
白話文教你怎麼寫，提升產品使用者的試用轉換率
Hi 我是朱騏 👋 又到了每週給你寫封信的時間啦～
這禮拜我利用中秋節時間，都在回顧筆記軟體中的筆記。
意外的挖到許多跟「寫作」有關的內容，連我都很驚訝自己竟然有寫過 XD
廢話不多說，直接進本週分享。
1 ACTION
好書推薦–總統文膽寫作課
閱讀時間： 1 分鐘
上禮拜五開始讀一本極其特殊的寫作書–《總統文膽寫作課》。
「文膽？好怪的單字。」我看到書名的當下，還真不知道是什麼意思。
快速 Google 後，原來「文膽」是指能為高階政治人物撰寫各種文書的幕僚人員。這本書的作者江原國，曾經為南韓 2 位最著名的總統–金大中、盧武鉉大量撰寫演講稿。
這本書有趣的地方在於：
1. 寫作的對象特殊：文章的使用者是總統，我們老百姓平常根本沒機會了解其中的內幕。
2. 寫作的情境特殊：文章的閱讀情境是節日、重要事件的公開發言，這跟平時在 Facebook/IG 上滑手機看到的很不一樣。
3. 給訣竅的人特殊：作者講說「我不是撰寫總統演說文稿的人，而是在總統身邊學會寫演說文稿。」這本書紀錄的，是兩位韓國總統個人的獨家寫作秘訣。
我們學習的對象，是南韓的 2 位總統！
我自己在網路上持續寫作 4 年，發現：「一位寫作者的文章要好看，他的人生閱歷要足夠豐富。(才有足夠的材料可以寫)」
以盧武鉉總統為例，
他是韓國歷史上學歷最低的總統，讀完初中後因為家境貧困，沒能升讀普通高中，而是選擇了釜山商業高中。
他通過自學苦讀，於1975年通過司法考試，成為一名法官。後來他轉行當律師，並參與了許多人權案件的辯護。
他獲得民眾的支持，最終成為總統。但卻在卸任後一年 (2009) 遭到貪污指控和調查，在自己的故鄉跳崖自殺。
「天哪...太戲劇的人生。」我看著維基百科上盧武鉉的生平。
書中除了講故事，也分享實用的寫作訣竅。例如盧武鉉總統的寫作 6 個訣竅：
1. 重要內容，必須寫在文章最前面
2. 統計數據，能夠增加文章可信度
3. 整篇文章，要能濃縮成一句標題
4. 文章越簡短，表達反而會更有力
5. 減少華麗辭藻，能讓人感到真誠
6. 詞彙務必要簡單，才能貼近聽眾
非常特別的一本寫作主題書籍，推薦給大家。
2 THOUGHTs
閱讀時間： 1 分鐘
💭 使用者不會用我家的軟體產品怎麼辦？寫 Tutorial 技術文件的 6 個訣竅，幫助你提升試用產品的轉換率
工作兩年，我已經替 5 個 SaaS 產品寫了技術文件。
過程中我發現：
現代人很沒耐心。
5 分鐘內他不知道產品怎麼用，就會關閉網頁再找其他試用品。
公司失去了一個願意付費的潛在客戶。
怎麼辦呢？你需要一份 Tutorial 技術文件！
Tutorial 是從 0 到 1 帶著使用者，快速走過 Onboarding 程序並且開始使用你的產品。
不用寫多，但要精簡。
下面是我總結的 6 個訣竅。
1. 萬年起手式：拿出一張白紙，寫下要開始使用產品的每一個步驟。(先打在筆記軟體上也行)
2. 一個步驟，一個動作：例如「點擊註冊」與「輸入基本資料」要分開寫，別寫成「註冊並輸入基本資料」。
3. 在開頭先預告有幾個步驟：例如 3 個步驟開始交易、5 個步驟完成串接，要做幾個步驟先跟使用者說。
4. 不展開細節：例如「輸入基本資料」包含了姓名、電話、Email、地址...，不需要特別提及要填寫什麼欄位。
5. 搭配截圖：一圖勝千言，文字搭配截圖最好懂。
6. 每個步驟都要取個標題：標題要劃重點的作用，5-10 個字最好。
試試看替你的公司產品寫份 Tutorial 文件吧！
💭 6 個給軟體產品經理的文件寫作訣竅，開始替自家 SaaS 產品寫出使用者好閱讀的 How-to 文件
承上篇。
隨著公司的產品/系統變得愈來愈複雜，你需要特別告訴使用者如何使用這些產品功能。
這就是 How-to 文件的作用，告訴使用者怎麼好好使用特定功能。
例如
如何建立一筆訂單（假設你是一家旅宿管理系統）
如何掛一筆期貨單（假設你是一個加密貨幣交易所）
如何串接第三方付款金流（假設你是一家無頭電商管理後台）
那該怎麼寫 How-to 文件呢？
根據 Divio Documentation system 的建議，有 6 個重要的訣竅。
專注結果：專注在幫助使用者完成一個任務。
不說觀念：把觀念獨立出來，寫成獨立一個頁面。
提供步驟：包含一系列清單的步驟，不需要有非常基礎的介紹。
解決問題：假設使用者已經知道要做什麼，但不知道"如何做"。
適當留白：如果問題有多種解法，只需要說常用的1-2種即可。
好好命名：讓使用者一眼就看懂，實務上常用「如何（How to）」來命名文件。
這樣做，就能寫出使用者好閱讀的 How-to 文件。
📢 想在 Facebook 上寫作分享想法，卻不知道如何開始嗎？
我提供一個付費電子報訂閱，幫助 25 ~ 35 歲的職場上班族學會在 Facebook 上寫出專業文章。
讓你有自信地分享專業內容，增加職場能見度。
點擊圖片瞧瞧吧 👇
3 IDEAs
34 種可以現學現賣的圖解模版
閱讀時間： 1 分鐘
大概念：Laura Evans-Hill 是一位視覺圖解教學者，這篇 Twitter 她分享了 34 種可以直接使用的視覺圖解模版。
重點：她將圖解模版分成 4 大類，有了這些框架，馬上就可以畫出吸睛的圖解了！
Storytelling (說故事)
Math (數據)
Tech (科技)
Framework (架構)
從做中學 (Learn through play)
閱讀時間： 1 分鐘
大概念：這個網站挺有意思的，有許多透過小遊戲/具體案例來教學特定學科的案例。
重點： 如果你是老師、講師需要解釋一個複雜的概念，可以來這裡挖寶教學案例。
畫程序圖的線上好工具-Web Sequence Diagrams
閱讀時間： 1 分鐘
大概念：程序圖 (Sequence diagram) 常被用在說明特定的流程。
重點： 這個網站將常用的程序圖元素模組化，你只要點擊、改字馬上就可以畫出一張清楚的程序圖了。