原子筆記要有向上的議題入口:讀者要知道為何讀這張、何時會撞到
原子筆記要有向上的議題入口:讀者要知道為何讀這張、何時會撞到
論述基礎與限制
本卡抽自一次術語卡撰寫的檢討(til/terms 14 卡)。限制:單一案例、單一內容類型(跨領域術語);「議題 hub + 原子卡」兩層結構對其他內容類型的適用性未驗證。與既有 教材完整性要用讀者旅程驗證 區分——那談課程級的學習路線,本卡談單張原子筆記的進入動機與其上層議題。
核心原則
承載知識的原子筆記不是字典條目。字典回答「這個詞是什麼」;承載知識的卡要回答「你在討論什麼、撞到什麼問題,才需要這個知識」。
撰寫者有預設的情境與前提,讀者沒有。所以每張原子卡(或它的上層)要提供進入動機:從情境進入,而非劈頭給定義。具體做法是建一層議題 hub——以讀者會遇到的問題為標題(「測試紅燈不一定是真的壞」「告警太多反而沒人看」),討論議題、再分流到底下的術語卡;術語卡頂部回指它出自哪個議題,讓搜尋直接落地者也有回路。
情境
til/terms 的術語卡初版,每張都從定義開頭:「alert fatigue 指誤報太多、人對告警麻木……」。內容正確,但讀者不知道自己為什麼會需要這個詞、何時會撞到——卡片成了字典。
理想做法
為每個分支建議題 hub(情境入口),從「你遇到什麼問題」進入、再導向該讀的術語卡;術語卡頂部加一行回指議題(「這個詞出現在『X』這個問題裡」)。形成「議題 hub(情境)→ 原子卡(定義)」兩層,讀者由動機而非定義進入。
沒這樣做的麻煩
卡淪為字典:讀者沒有觸發點,搜尋落地後讀完仍不知這對他有何用,知識無法在「對的時機」被取用。承載知識的內容若只有定義層、缺議題層,就退化成可被任何字典取代的條目,失去 blog 累積知識的價值。
判讀徵兆
- 卡片開頭是「X 指……」的定義句,沒有情境鋪陳。
- 問「讀者為什麼要讀這張卡」答不出來,或答案是「為了知道定義」。
- 一組原子卡彼此互連,卻沒有上層的議題導讀帶讀者進入。