範例讓最後一類出口缺口現形,而盤點要跨兩個階段各跑一次
論述基礎與限制
本卡從兩篇資安選型章節補完範例之後的一輪盤點抽出。兩篇都經過完整的多輪審查、也都剛補過系統形態與微案例,技術正確、結構完整、路由段齊備。補完之後改用一個新問題掃全文:讀者現在知道這是問題了,他去哪解決。
盤點結果是七處缺出口。其中兩處的目的地其實存在且承接該主題,只是連結在一百行之後的文末路由段——讀者在問題發生的位置提出疑問,答案放在他讀完整篇之後才會遇到的地方。另外三處是主題根本沒有落點,而文中沒有任何一句說明它不存在;讀者找不到時的預設歸因是自己沒找到,於是把時間花在搜尋上。
這七處在那一輪之前都沒有被發現過,而那一輪同時改變了兩件事:補上了微案例,並且改用一個新問題掃全文。事後拆開來看,七處裡只有兩處依附於微案例(它們是微案例末端那句「補起來要……」帶出來的),其餘五處掛在問題節點表與風險邊界上——那兩種單位在任何微案例存在之前就已經存在。真正讓它們現形的是換視角,不是補範例。
限制:本卡談教學內容的出口完整性,適用於判讀 / 選型 / 決策類與操作類內容。純參考類(規格表、API 文件)以查詢為目的,讀者不帶問題來,不適用。
核心原則
出口盤點的視角是讀者的下一個動作,而單位是每一句「指名了問題卻沒有就地解決」的話——其中只有一類要等範例存在,因此盤點要跨兩個階段各跑一次。 判讀表的每一列、風險邊界的每一條、out-of-scope 的每一項宣告任何時候都掃得到;微案例末端那句「補起來要……」要等微案例寫出來才有。把整個盤點延到補完範例之後,前兩種單位的缺口會被拖著;只在補範例之前掃一次,第三種永遠掃不到。
真正讓缺口現形的是換視角。所有既有的檢查維度都在驗「已經寫的內容對不對」:技術正確、規範合格、結構完整、路由段存在。缺的是「這一段提出的問題有沒有被接住」,而那要用讀者的下一個動作當視角,不是用段落本身當視角。用段落當視角時「撤銷等於中斷整條整合」讀起來完整——句子把後果講清楚了、本身沒有缺口。
範例在這件事上的貢獻是多出一類單位,其餘各類與它無關。四拍的最後一拍是止血代價,它把讀者推到「所以要怎麼止血」,而那個問題在分析段落裡不會被問到——這一類缺口確實只有補完範例才掃得出來。
檢查單位是每個被提出的問題,不是每篇文章
文末的「下一步路由」段是文章層級的出口。它回答「讀完整篇之後往哪走」,回答不了「讀到第三節這一句時我該怎麼辦」。有路由段的文章仍然可以在段落層級處處落空。
盤點的單位因此是每一個被提出的問題,判準是「這一句指名了一個問題而沒有就地解決它」。這是規則而不是清單——本卡最初把它寫成三項封閉枚舉(判讀表的列、風險邊界的條、微案例末端的止血句),而下方判讀徵兆自己就列了第四類(out-of-scope 宣告到「不在本章範圍」為止),那一類在多數章節的密度還高於前三類。收斂動作段的每一步、跨章交叉引用段同樣會生出新問題。
命中率最高的仍然是那三類,掃描時先掃它們;而三類裡只有微案例末端要等第二階段才存在。
微案例末端的命中率最高,也是唯一要等範例存在的一種;其餘各類在文章寫完的當下就可以掃,不必等。
四種出口狀態與處置
出口存在且就在手邊——合格,不必動。
出口存在但在文末——目的地承接該主題、連結也有效,只是離問題發生的位置太遠。就地補一句連結,並在句子裡說明去那裡要拿到什麼。這是可達性問題在文章內部的形態,與 #240 的模組層可達是同一個機制。
出口不存在、而主題能用最小可行答案打發——當場補。判準是一段話加幾個連結能不能讓讀者繼續往下走;能的話寫進本文,主題份量夠獨立成篇的就寫簡版新章節,深度留待辦。簡版要在開頭明說自己是簡版與缺什麼,否則它會被當成完整內容而永遠不被補完。
出口不存在、而主題需要完整推導——明說它不存在,並給一條最小判準讓讀者當下不至於卡住。明說是這一格的重點:讀者找不到某個主題時的預設歸因是自己沒找到,沉默會讓他把時間花在搜尋上。給最小判準則讓「尚無專章」不等於「無從下手」。
而「已列入待辦」不要寫進正文。 這一格要交給讀者的是兩件事——它不存在、以及在那之前怎麼辦——待辦狀態是第三件,屬於維護者。差別在讀者拿它做不了任何事:他無法據此調整判斷,只會知道作者記得這件事。內部狀態的住址是那份待辦清單本身,而正文寫進去之後兩處會各自漂移,那時清單被清掉而正文還在說它排著。
反模式:刪範例時連帶刪掉唯一的止血知識
微案例的第四拍(止血代價)常常是全篇唯一寫出止血路徑的地方。依「挑後果最不直觀的一兩個形態寫」的規則替換微案例時,被換掉的那則裡的止血資訊會一起消失,而替換的理由(後果太直觀)只評估了前三拍。
實際發生過:一則微案例因為後果過於直觀被換掉,而它的第四拍是全篇唯一提到「換密鑰會讓所有還沒更新的使用者一起失效」的地方。替換當下沒有人注意到這一句沒有別的落點,直到出口盤點才補回來。
處置是替換微案例前先掃第四拍:那句止血描述在文章別處有沒有第二個出處。沒有的話先把它移進風險邊界或判讀段,再替換。
跟其他原則的關係
- #242 形態讓讀者對號入座,微案例才讓他想像得出後果:本卡承接它的產物。#242 說明微案例讓後果可想像,而可想像的後果會產生一個新問題(怎麼辦)——那是出口盤點三種單位裡的第三種。兩張卡的關係是交錯而非前後接續:出口盤點在形態階段跑一次(涵蓋節點表與風險邊界),微案例寫完再跑一次(涵蓋止血代價那一類)。
- #240 跨模組路由要驗證目的地承接該主題:#240 檢查已經寫下的路由指得對不對,本卡檢查該有路由的地方有沒有路由。前者驗既有連結的品質,後者驗連結的覆蓋;一篇文章可以每條路由都正確而仍然處處落空。
- #241 判讀層只給機制屬性時,可用程度隨讀者既有經驗遞減:同一個投射的兩種形態。#241 是作者假設讀者知道什麼時候會遇到,本卡是作者假設讀者知道遇到之後怎麼辦。兩者都因為作者自己兩件事都知道而不可見。
- #246 被多篇當成前提的判斷缺的是住址:本卡第四種狀態(出口不存在就明說並給最小判準)的反面。那一格處理的是單篇視角下的落空,而 #246 的缺口在單篇視角下不落空——每一篇都給了自己那一角、讀者當下走得下去,要看見它必須換成跨篇視角。
- #126 寫作 review 是多軸完整性、不是單軸深度:缺出口是又一條沒有人負責的軸——既有維度都在驗已寫內容的正確性,沒有一項在驗「提出的問題有沒有被接住」。
判讀徵兆
- 文章有完整的「下一步路由」段,而正文某一節的問題在那個段裡找不到對應項。
- 微案例的最後一拍寫了止血代價,而全文沒有任何一處說明止血要怎麼做。
- 某個主題在文中被提到「不在本章範圍」,句子到此為止而沒有給落點。
- 讀者問「這個情境有對應的解決方案章節嗎」——這個提問形態代表他已經認同問題、卡在下一步。
- 出口只盤點過一次:兩個階段各跑一次才涵蓋三種單位,一次掃描必然漏掉其中一類。
- 掃描報告說「路由段齊備、無缺口」:這是段落視角的結論,換成讀者的下一個動作當視角會得到另一份清單。