<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/"><channel><title>讀者旅程 on Tarragon</title><link>https://tarrragon.github.io/blog/tags/%E8%AE%80%E8%80%85%E6%97%85%E7%A8%8B/</link><description>Recent content in 讀者旅程 on Tarragon</description><generator>Hugo -- gohugo.io</generator><language>zh-TW</language><copyright>Tarragon (CC BY 4.0)</copyright><lastBuildDate>Thu, 11 Jun 2026 00:00:00 +0000</lastBuildDate><atom:link href="https://tarrragon.github.io/blog/tags/%E8%AE%80%E8%80%85%E6%97%85%E7%A8%8B/index.xml" rel="self" type="application/rss+xml"/><item><title>入口分流要放在詞彙牆之前、門外讀者要在門外就拿到岔路</title><link>https://tarrragon.github.io/blog/report/audience-fork-before-jargon-wall/</link><pubDate>Thu, 11 Jun 2026 00:00:00 +0000</pubDate><guid>https://tarrragon.github.io/blog/report/audience-fork-before-jargon-wall/</guid><description>&lt;h2 id="結論">結論&lt;/h2>
&lt;p>入口頁的開頭屬於最外圈讀者 — 背景最少、最容易跳出的那群人、決定了分流句能放多深。&lt;strong>分流要出現在他們還活著的位置&lt;/strong>：開頭每多一段他們看不懂的內容、活到分流點的機率就掉一截；分流句寫得再清楚、放在詞彙牆後面就等於沒寫、會被牆擋住的讀者正是分流要服務的讀者。&lt;/p>
&lt;p>操作型判準：找出入口頁服務的最外圈讀者、用他的詞彙量重讀開頭 — 第一個他看不懂的術語出現之前、他需要的分流出現了嗎？&lt;/p>
&lt;h2 id="為什麼分流會自然長在牆後">為什麼分流會自然長在牆後&lt;/h2>
&lt;p>入口頁通常由門內的人維護、預設讀者跟自己共享詞彙。為門外讀者補新章節時、自然的動作是「把新章節加進章節列表、在相關段落補一句路由」— 而「相關段落」的位置由內容邏輯決定（交付形態的討論屬於需求討論的前提、所以放在需求討論段前）、不是由讀者存活曲線決定。內容邏輯上正確的位置、可以在讀者旅程上完全失效：邏輯說「這段在第 41 行很合理」、旅程說「目標讀者活不過第 10 行」。&lt;/p>
&lt;p>兩個座標系都對、服從的對象不同 — 入口頁的開頭屬於旅程座標系、內容深處才屬於邏輯座標系。&lt;/p>
&lt;h2 id="反模式與修法">反模式與修法&lt;/h2>
&lt;table>
 &lt;thead>
 &lt;tr>
 &lt;th>反模式&lt;/th>
 &lt;th>修法&lt;/th>
 &lt;/tr>
 &lt;/thead>
 &lt;tbody>
 &lt;tr>
 &lt;td>分流句放在「邏輯上相關」的段落、不管該段落多深&lt;/td>
 &lt;td>分流句在開頭一、二段內出現、邏輯位置可以放第二份&lt;/td>
 &lt;/tr>
 &lt;tr>
 &lt;td>章節列表按編號排、門外讀者的章節排在幾十列門內章節後&lt;/td>
 &lt;td>列表順序維持、但開頭的分流句直接連到該章節、不靠讀者掃列表&lt;/td>
 &lt;/tr>
 &lt;tr>
 &lt;td>入口頁開頭堆共同詞彙索引、預設讀者先去補課&lt;/td>
 &lt;td>補課指引放在分流之後 — 先讓每種讀者找到自己的路、再談前置知識&lt;/td>
 &lt;/tr>
 &lt;tr>
 &lt;td>用「本模組預設 X」的宣告代替分流&lt;/td>
 &lt;td>宣告要配出口：「預設自建已成立；尚未確定的讀者、先讀（連結）」&lt;/td>
 &lt;/tr>
 &lt;/tbody>
&lt;/table>
&lt;p>位置的選擇可以很粗暴：入口頁前三句之內、每一種讀者都拿得到一個自己看得懂的出口。內容邏輯再怎麼支持別的位置、都排在這個約束後面。&lt;/p>
&lt;h2 id="跟其他抽象層原則的關係">跟其他抽象層原則的關係&lt;/h2>
&lt;ul>
&lt;li>&lt;a href="https://tarrragon.github.io/blog/report/teaching-completeness-by-learner-journey/" data-link-title="教材完整性要用讀者旅程驗證" data-link-desc="教材完整性要用讀者旅程驗證；章節數、案例數或 vendor 覆蓋度只能判斷素材量。成熟教材要能回答不同讀者從哪裡開始、按什麼順序讀、讀完能做什麼。LLM 與 Go 目錄顯示，讀者旅程、學習梯度與主題導讀是教學設計完成度的核心訊號。">#131 教材完整性要用讀者旅程驗證&lt;/a>：本卡是 #131 在「入口頁」這個單點的特化。#131 驗證整條旅程（從哪開始、按什麼順序、讀完能做什麼）、本卡聚焦旅程的第 0 步 — 旅程設計得再好、入口斷路就沒有人走上來。&lt;/li>
&lt;li>&lt;a href="https://tarrragon.github.io/blog/report/top-level-content-folder-needs-homepage-entry/" data-link-title="新增頂層 content 資料夾要同步首頁 _index.md 入口" data-link-desc="Hugo 不會 auto-list 頂層資料夾、首頁的模組清單是 content/_index.md 的手動 curated markdown。新增 content/&amp;lt;module&amp;gt;/ 後若沒同步加入口、模組在首頁完全不可發現；讀者只能靠搜尋或直接打 URL 才進得去。本卡把『新增頂層資料夾 &amp;#43; 首頁入口』綁成同 commit 的雙生動作、避免下次再漏。是 #44 SSoT 在『首頁清單』維度 &amp;#43; #97 metadata surface 在『上層索引』維度的具體案例。">#139 新增頂層 content 資料夾要同步首頁入口&lt;/a>：同屬「內容存在 ≠ 內容可達」家族。#139 處理結構性不可達（首頁清單沒列、完全找不到）、本卡處理體驗性不可達（列了、但目標讀者活不到那一行）— 後者更隱蔽、因為 link checker 與結構審查都會通過。&lt;/li>
&lt;li>&lt;a href="https://tarrragon.github.io/blog/report/metadata-surface-in-writing-review/" data-link-title="Metadata surface 要納入寫作 review 範圍" data-link-desc="寫作 review 的 surface 包含正文與 metadata surface：title、description、frontmatter、heading、link label、MOC 索引條。正文通過 positive wording 或 multi-pass review 只代表 body surface 收斂；讀者入口與索引入口也要跑同一套 frame，才能讓文章在第一眼、搜尋與跨篇路由上維持同一個概念錨點。">#97 Metadata surface 要納入寫作 review 範圍&lt;/a>：#97 的 navigation surface 列舉的是索引條目、MOC hook 與 link label；本卡把入口頁的開頭段視為這個 surface 的延伸 — 這是本卡的擴張、原卡分類未列 — 理由是它跟那批元素共享同一個責任：決定讀者入口、跟正文品質是兩個 review 維度。新章節寫完只 review 章節本身、入口 surface 的失效就漏掉了；本卡的 case 正是被 reader-simulation 而不是內容 review 抓到。&lt;/li>
&lt;li>&lt;a href="https://tarrragon.github.io/blog/report/search-engine-matching-mode-mismatch/" data-link-title="搜尋引擎的匹配模式跟使用者預期的對齊" data-link-desc="搜尋引擎的匹配模式（prefix / substring / fuzzy / semantic）各有不同。預設多半是 prefix（為了 index size）、但使用者被 Google 訓練成預期 substring。沒對齊 = silent 失敗：搜「pre」找不到 backpressure。本卡展開五種匹配模式、跟使用者意圖的對齊協議、五個合成策略。">#73 搜尋引擎的匹配模式跟使用者預期對齊&lt;/a>：同型的「入口錯位 = silent 失敗」— 使用者帶著自己的模型來、系統用另一個模型回應、沒有錯誤訊息、只有流失。&lt;/li>
&lt;/ul>
&lt;h2 id="觸發-case">觸發 case&lt;/h2>
&lt;p>一個後端選型模組為「還沒決定要不要自建的讀者」補了交付形態章節（託管平台 / BaaS / 自建的判讀）— 這是整個模組唯一為光譜左端讀者寫的內容。Reader-simulation 審查用人設實走：獨立開發者、剛用低程式碼工具做完接案網站、想知道該不該自建。結果：模組入口頁開頭三段全是自建世界的詞彙（consumer lag、dead-letter queue、replay）、唯一的分流句在第 41 行的「需求討論順序」標題下、章節列表中該章排在第 17 列 — reviewer 的判定是「這個讀者最可能的真實行為：開頁、前兩段每個名詞都不認識、跳出、根本走不到那一章」。修復後的入口頁在第二段就給出分流（值不值得自建、連到該章）、原本第 41 行的路由保留作第二觸點。&lt;/p>
&lt;h2 id="判讀徵兆">判讀徵兆&lt;/h2>
&lt;ul>
&lt;li>為新讀者群補了內容、commit 裡只有新章節跟列表項、入口頁開頭沒動 — 大概率長在牆後。&lt;/li>
&lt;li>入口頁 review 用門內視角讀（「資訊都在」）— 換最外圈讀者的詞彙量重讀開頭十行、數第一個陌生術語出現的位置。&lt;/li>
&lt;li>分流句的位置由「內容邏輯歸屬」決定而不是「讀者存活範圍」決定 — 兩個座標系打架時、開頭讓給旅程座標系。&lt;/li>
&lt;/ul></description><content:encoded><![CDATA[<h2 id="結論">結論</h2>
<p>入口頁的開頭屬於最外圈讀者 — 背景最少、最容易跳出的那群人、決定了分流句能放多深。<strong>分流要出現在他們還活著的位置</strong>：開頭每多一段他們看不懂的內容、活到分流點的機率就掉一截；分流句寫得再清楚、放在詞彙牆後面就等於沒寫、會被牆擋住的讀者正是分流要服務的讀者。</p>
<p>操作型判準：找出入口頁服務的最外圈讀者、用他的詞彙量重讀開頭 — 第一個他看不懂的術語出現之前、他需要的分流出現了嗎？</p>
<h2 id="為什麼分流會自然長在牆後">為什麼分流會自然長在牆後</h2>
<p>入口頁通常由門內的人維護、預設讀者跟自己共享詞彙。為門外讀者補新章節時、自然的動作是「把新章節加進章節列表、在相關段落補一句路由」— 而「相關段落」的位置由內容邏輯決定（交付形態的討論屬於需求討論的前提、所以放在需求討論段前）、不是由讀者存活曲線決定。內容邏輯上正確的位置、可以在讀者旅程上完全失效：邏輯說「這段在第 41 行很合理」、旅程說「目標讀者活不過第 10 行」。</p>
<p>兩個座標系都對、服從的對象不同 — 入口頁的開頭屬於旅程座標系、內容深處才屬於邏輯座標系。</p>
<h2 id="反模式與修法">反模式與修法</h2>
<table>
  <thead>
      <tr>
          <th>反模式</th>
          <th>修法</th>
      </tr>
  </thead>
  <tbody>
      <tr>
          <td>分流句放在「邏輯上相關」的段落、不管該段落多深</td>
          <td>分流句在開頭一、二段內出現、邏輯位置可以放第二份</td>
      </tr>
      <tr>
          <td>章節列表按編號排、門外讀者的章節排在幾十列門內章節後</td>
          <td>列表順序維持、但開頭的分流句直接連到該章節、不靠讀者掃列表</td>
      </tr>
      <tr>
          <td>入口頁開頭堆共同詞彙索引、預設讀者先去補課</td>
          <td>補課指引放在分流之後 — 先讓每種讀者找到自己的路、再談前置知識</td>
      </tr>
      <tr>
          <td>用「本模組預設 X」的宣告代替分流</td>
          <td>宣告要配出口：「預設自建已成立；尚未確定的讀者、先讀（連結）」</td>
      </tr>
  </tbody>
</table>
<p>位置的選擇可以很粗暴：入口頁前三句之內、每一種讀者都拿得到一個自己看得懂的出口。內容邏輯再怎麼支持別的位置、都排在這個約束後面。</p>
<h2 id="跟其他抽象層原則的關係">跟其他抽象層原則的關係</h2>
<ul>
<li><a href="/blog/report/teaching-completeness-by-learner-journey/" data-link-title="教材完整性要用讀者旅程驗證" data-link-desc="教材完整性要用讀者旅程驗證；章節數、案例數或 vendor 覆蓋度只能判斷素材量。成熟教材要能回答不同讀者從哪裡開始、按什麼順序讀、讀完能做什麼。LLM 與 Go 目錄顯示，讀者旅程、學習梯度與主題導讀是教學設計完成度的核心訊號。">#131 教材完整性要用讀者旅程驗證</a>：本卡是 #131 在「入口頁」這個單點的特化。#131 驗證整條旅程（從哪開始、按什麼順序、讀完能做什麼）、本卡聚焦旅程的第 0 步 — 旅程設計得再好、入口斷路就沒有人走上來。</li>
<li><a href="/blog/report/top-level-content-folder-needs-homepage-entry/" data-link-title="新增頂層 content 資料夾要同步首頁 _index.md 入口" data-link-desc="Hugo 不會 auto-list 頂層資料夾、首頁的模組清單是 content/_index.md 的手動 curated markdown。新增 content/&lt;module&gt;/ 後若沒同步加入口、模組在首頁完全不可發現；讀者只能靠搜尋或直接打 URL 才進得去。本卡把『新增頂層資料夾 &#43; 首頁入口』綁成同 commit 的雙生動作、避免下次再漏。是 #44 SSoT 在『首頁清單』維度 &#43; #97 metadata surface 在『上層索引』維度的具體案例。">#139 新增頂層 content 資料夾要同步首頁入口</a>：同屬「內容存在 ≠ 內容可達」家族。#139 處理結構性不可達（首頁清單沒列、完全找不到）、本卡處理體驗性不可達（列了、但目標讀者活不到那一行）— 後者更隱蔽、因為 link checker 與結構審查都會通過。</li>
<li><a href="/blog/report/metadata-surface-in-writing-review/" data-link-title="Metadata surface 要納入寫作 review 範圍" data-link-desc="寫作 review 的 surface 包含正文與 metadata surface：title、description、frontmatter、heading、link label、MOC 索引條。正文通過 positive wording 或 multi-pass review 只代表 body surface 收斂；讀者入口與索引入口也要跑同一套 frame，才能讓文章在第一眼、搜尋與跨篇路由上維持同一個概念錨點。">#97 Metadata surface 要納入寫作 review 範圍</a>：#97 的 navigation surface 列舉的是索引條目、MOC hook 與 link label；本卡把入口頁的開頭段視為這個 surface 的延伸 — 這是本卡的擴張、原卡分類未列 — 理由是它跟那批元素共享同一個責任：決定讀者入口、跟正文品質是兩個 review 維度。新章節寫完只 review 章節本身、入口 surface 的失效就漏掉了；本卡的 case 正是被 reader-simulation 而不是內容 review 抓到。</li>
<li><a href="/blog/report/search-engine-matching-mode-mismatch/" data-link-title="搜尋引擎的匹配模式跟使用者預期的對齊" data-link-desc="搜尋引擎的匹配模式（prefix / substring / fuzzy / semantic）各有不同。預設多半是 prefix（為了 index size）、但使用者被 Google 訓練成預期 substring。沒對齊 = silent 失敗：搜「pre」找不到 backpressure。本卡展開五種匹配模式、跟使用者意圖的對齊協議、五個合成策略。">#73 搜尋引擎的匹配模式跟使用者預期對齊</a>：同型的「入口錯位 = silent 失敗」— 使用者帶著自己的模型來、系統用另一個模型回應、沒有錯誤訊息、只有流失。</li>
</ul>
<h2 id="觸發-case">觸發 case</h2>
<p>一個後端選型模組為「還沒決定要不要自建的讀者」補了交付形態章節（託管平台 / BaaS / 自建的判讀）— 這是整個模組唯一為光譜左端讀者寫的內容。Reader-simulation 審查用人設實走：獨立開發者、剛用低程式碼工具做完接案網站、想知道該不該自建。結果：模組入口頁開頭三段全是自建世界的詞彙（consumer lag、dead-letter queue、replay）、唯一的分流句在第 41 行的「需求討論順序」標題下、章節列表中該章排在第 17 列 — reviewer 的判定是「這個讀者最可能的真實行為：開頁、前兩段每個名詞都不認識、跳出、根本走不到那一章」。修復後的入口頁在第二段就給出分流（值不值得自建、連到該章）、原本第 41 行的路由保留作第二觸點。</p>
<h2 id="判讀徵兆">判讀徵兆</h2>
<ul>
<li>為新讀者群補了內容、commit 裡只有新章節跟列表項、入口頁開頭沒動 — 大概率長在牆後。</li>
<li>入口頁 review 用門內視角讀（「資訊都在」）— 換最外圈讀者的詞彙量重讀開頭十行、數第一個陌生術語出現的位置。</li>
<li>分流句的位置由「內容邏輯歸屬」決定而不是「讀者存活範圍」決定 — 兩個座標系打架時、開頭讓給旅程座標系。</li>
</ul>
]]></content:encoded></item></channel></rss>