"教材設計"
- 教材目標先於決策框架
教材的核心目標是讓讀者學會某個領域的心智模型、操作語意與演進路徑;服務能力、風險、成本與決策是教學中的必要概念框架。當決策框架取代教材目標,文章會變成選型分析或治理文件,讀者知道怎麼判斷,卻仍缺少領域學習路線。
- 教材完整性要用讀者旅程驗證
教材完整性要用讀者旅程驗證;章節數、案例數或 vendor 覆蓋度只能判斷素材量。成熟教材要能回答不同讀者從哪裡開始、按什麼順序讀、讀完能做什麼。LLM 與 Go 目錄顯示,讀者旅程、學習梯度與主題導讀是教學設計完成度的核心訊號。
- 貫穿式案例是服務教材的教學骨架
服務型教材需要一條可重播的貫穿式案例,把資料庫、快取、queue、觀測、部署、可靠性、資安、事故與容量串成同一個服務演進路徑。沒有貫穿式案例時,章節會各自正確但讀者難以理解能力之間如何交接。
- 服務頁教材合約
服務頁是一篇能獨立教會讀者某個服務能力的教材,產品資訊與選型摘要只是教材材料。成熟服務頁要達到單篇技術教材的討論細節與漸進教學,但章節結構要依分類責任、服務對象與使用情境設計。