論述基礎與限制

本卡抽自 infra 教學模組的寫作 retrospective。21 篇文章初稿完成後，入門層文章（「個人專案到團隊服務」「一台機器到三個環境」）和溝通層文章（「給非工程人員的 infra 說明」）採用了宣導式框架（故事線導入、辦公室比喻、「跑得好好的」語氣），經作者 review 判定不適合目標讀者，重寫為「補足專業人士經驗缺口」的框架。限制：evidence 來自單一教學模組的一次重寫週期，跨領域適用性未驗證。

核心原則

技術教材的讀者是在特定領域缺乏經驗的專業人士，不是完全不懂的外行人。他們有系統思考能力、理解風險與成本、能處理抽象概念，只是沒有經歷過這個領域的具體情境。

寫法的差別在於進入方式：

寫法預設效果
科普宣導讀者不懂、需要被說服降低可信度 — 專業人士感到被低估
經驗補足讀者有能力判斷、缺的是情境建立信任 — 讀者在熟悉的認知框架裡接收新資訊

情境

infra 教學模組的入門層文章原本採用宣導式框架：

  • 「一台機器跑得好好的」— 預設讀者沒想過為什麼需要多環境
  • 「個人專案到團隊服務：infra 在哪裡出現」— 用 side project 故事引導讀者「發現」infra
  • 「用辦公室理解 infra」— 用辦公大樓、門禁卡、資產清冊比喻 VPC、IAM、state

這些框架的問題是它們預設讀者既不知道 infra 存在、也無法理解技術概念。但教材的目標讀者是專業工程師（缺 infra 經驗但有系統思考能力）和專業決策者（缺技術細節但懂營運風險）。宣導式語氣對這兩類讀者都是失配。

理想做法

對工程師讀者

直接描述情境和操作需求，不用故事線包裝。不說「跑得好好的、直到有一天…」，而說「單機環境在需要測試環境時會遇到三個操作問題」。讀者有能力從情境描述中自行判斷這跟自己的關聯。

每個概念用「它解什麼問題、不管理時的後果」框架帶入，不用「你可能沒注意到，其實你已經在用…」的發現式框架。後者暗示讀者對自己的工作環境不熟悉。

對非工程決策者

減少專業術語、讓討論的情境從簡單到複雜遞進，而非大量使用比喻。比喻的問題是它只傳遞形狀、不傳遞嚴重性 — 「VPC 像辦公大樓」讓人理解隔離的概念，但不讓人理解隔離失敗時的商業代價。從管理層面解釋「會發生什麼事、為什麼要避免、發生了怎麼處理」比從技術層面解釋「這個元件是什麼」有效。

決策者需要的資訊是：這個風險的量級（影響多少客戶、停多久、多少錢）、補救的成本曲線（現在做 vs 半年後做的差距）、以及投入的時間框架。這些都是他們熟悉的決策維度，用這些維度講就好。

沒這樣做的麻煩

宣導式寫法的具體代價：

  • 可信度損失：工程師讀到「你可能不知道」時，如果他其實知道（只是沒做過），教材在他心中的權威性立刻下降。一旦開頭失去信任，後面的技術判準也會被打折。
  • 比喻阻礙深度理解：讀者記住了「VPC 像辦公大樓」，但當他需要判斷 CIDR 該切多大、需不需要跟其他 VPC peering 時，比喻反而成為思考的障礙 — 辦公大樓沒有地址空間的概念。
  • 推動失效：infra 推不動的原因是「提案語言跟決策者語言對不上」，不是「決策者太笨聽不懂」。把溝通問題歸因成理解力問題，會導致越比喻越多、越比喻越離題。

判讀徵兆

寫教材時如果發現自己在用以下句型，代表可能掉進了宣導式框架：

  • 「你可能沒注意到…」「你可能不知道…」— 預設讀者無知
  • 「想像一下…」「把 X 想成 Y…」— 用比喻替代直接說明
  • 「跑得好好的」「聽起來很複雜」— 用語氣管理讀者情緒
  • 「其實很簡單」「說穿了就是」— 降低複雜度的假象

替代方式：直接描述情境、列出操作需求、說明不做的後果。讀者有能力從事實中得出判斷。

跟其他抽象層原則的關係