前言

在 Hello Worlde Dev Conference Centralized CI/CD 策略的探索與實踐 提到一件事，解決問題，將影響留存下來。

留存最好的方式就是寫文件！不只是有沒有寫，而是這份文件有沒有發揮價值！

面對不同的目標或是閱讀者，會有完全不同的寫作方式，講者推薦一本 高產出的本事：用8種表達框架X4張圖X15分鐘， 文章、簡報，圖解一次到位，讓輸出成為你的優勢

框架 = 讓人輕鬆理解的概念

整場聽下來很流暢，簡報也很用心，看得出來很多自己畫的圖，是一場印象深刻的議程！

表達框架

可以挑選適合的框架來組織簡報、演講或是文章的資訊

• 重點框架：講重點！建議三個就好！目的是要聚焦。
• 清單框架：列出清單讓讀者或聽眾選擇，不要超過 10 項。
• 時間框架：利用時間軸描述。例如：過去 -> 現在 -> 未來、短中長期或是步驟一二三。
• 空間框架：先講整體再聚焦到局部。
• 主題框架：Why -> How -> What。
• 議題框架：想要說明主張或是說服別人的時候，利用 論點 -> 理由 -> 實例 -> 重申
• 問題框架：需要提出解決方案的時候，利用 情境 -> 衝擊/影響誰 -> 要解決的問題 -> 方案
• 課題框架：用來展示成果用，利用 任務緣由 -> 任務目標 -> 行動 -> 成果

圖解

圖像化方式，幫助受眾理解或是吸收

• 樹狀圖：適合歸納用，例如：組職圖、心智圖、魚骨圖
• 流程圖：適合闡述運作機制，例如：使用箭頭引導或是以不同圖案、大小、顏色顯示差異
• 矩陣圖：適合定位交互比較
• 文氏圖：強調交集關係

圖取自 全息圖解析02：如何將心智圖轉化為全息圖，吸睛又有記憶點？

聯想

解決問題，將影響留存下來

聯想到的是，以前在專案 WIKI 或是 README 中，總會有一個區塊是前輩們把曾經遇到過的問題記錄下來，包含問題是什麽？為什麽有這個問題？要怎麼處理？

前輩也都會鼓勵大家做紀錄！因為你遇到的，別人也會遇到！

寫文件很花時間，甚至是個沒有人在乎的工作項目

但，成為付出者，收穫最多的會是自己。

參考資源

我也想好好寫文件 - Documentation System 的具體寫作指引 (講者 Blog 文章)
全息圖解析02：如何將心智圖轉化為全息圖，吸睛又有記憶點？ (高產出的本事 - 作者 Blog 文章)
《高產出的本事》：8框架+4圖解，讓你溝通、簡報、寫文不用愁！