<?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>Reader-First on Tarragon</title><link>https://tarrragon.github.io/blog/tags/reader-first/</link><description>Recent content in Reader-First on Tarragon</description><generator>Hugo -- gohugo.io</generator><language>zh-TW</language><copyright>Tarragon (CC BY 4.0)</copyright><lastBuildDate>Thu, 25 Jun 2026 00:00:00 +0000</lastBuildDate><atom:link href="https://tarrragon.github.io/blog/tags/reader-first/index.xml" rel="self" type="application/rss+xml"/><item><title>讀者不需要知道 — 刪除比解釋更尊重讀者</title><link>https://tarrragon.github.io/blog/report/reader-does-not-need-to-know/</link><pubDate>Thu, 25 Jun 2026 00:00:00 +0000</pubDate><guid>https://tarrragon.github.io/blog/report/reader-does-not-need-to-know/</guid><description>&lt;h2 id="結論">結論&lt;/h2>
&lt;p>文章中的 meta 資訊（「這篇文章的目的是…」「本文邊界是…」「先交代脈絡，否則…」）服務的是作者，不是讀者。讀者打開文章的問題是「這篇文章對我有什麼用」，而非「作者為什麼寫這篇文章」。&lt;/p>
&lt;h2 id="案例">案例&lt;/h2>
&lt;h3 id="案例一整理目的-blockquote">案例一：整理目的 blockquote&lt;/h3>
&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;code>&amp;gt; **整理目的**：這不是一次性事件的檢討報告，而是對「工具設計者的責任邊界」的反思。&lt;/code>&lt;/td>
 &lt;/tr>
 &lt;tr>
 &lt;td>修正後&lt;/td>
 &lt;td>（整段刪除，改為直述讀者能帶走什麼）&lt;/td>
 &lt;/tr>
 &lt;/tbody>
&lt;/table>
&lt;p>「整理目的」告訴讀者作者為什麼寫這篇文章。但讀者的問題不是「你為什麼寫」，而是「我為什麼要讀」。兩者的差別：&lt;/p>
&lt;ul>
&lt;li>作者視角：「這是一篇反思，不是事件報告」→ 在做分類&lt;/li>
&lt;li>讀者視角：「讀完這篇我能改善什麼？」→ 在評估投入回報&lt;/li>
&lt;/ul>
&lt;h3 id="案例二脈絡解釋">案例二：脈絡解釋&lt;/h3>
&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;/tbody>
&lt;/table>
&lt;p>這句話是寫給自己的編輯註記——「提醒自己為什麼要寫背景段」。讀者不需要知道作者的編輯考量。章節標題（「背景：我們怎麼管理版本和工作項目」）已經告訴讀者接下來是脈絡交代。&lt;/p>
&lt;h2 id="判斷標準">判斷標準&lt;/h2>
&lt;p>寫完一段 meta 描述後問：&lt;strong>這段話消失後，讀者的閱讀體驗會變差嗎？&lt;/strong>&lt;/p>
&lt;ul>
&lt;li>「整理目的」消失 → 讀者仍然能從內文判斷這是反思而非報告 → 不會變差 → 刪除&lt;/li>
&lt;li>「先交代脈絡」消失 → 讀者仍然會讀到脈絡段 → 不會變差 → 刪除&lt;/li>
&lt;li>semver 背景段消失 → 讀者會在事件段卡住 → 會變差 → 保留&lt;/li>
&lt;/ul>
&lt;p>meta 資訊的本質是「替讀者做他已經能自己做的事」。讀者能從標題和內文推斷文章類型，不需要作者顯式宣告。&lt;/p>
&lt;h2 id="ai-寫作的傾向">AI 寫作的傾向&lt;/h2>
&lt;p>AI 生成的文章高頻出現 meta 資訊，因為 AI 的生成過程包含「規劃→組織→寫作」三步，meta 資訊是規劃步驟的殘留——AI 把內部的推理過程（「我接下來要先交代脈絡」）外露到了文章中。&lt;/p>
&lt;p>生成端防護：完成初稿後掃描所有 blockquote 和段首句，問「這句在描述內容還是在描述寫作過程？」描述寫作過程的句子刪除。&lt;/p>
&lt;p>&lt;strong>場景邊界&lt;/strong>：此判斷適用於短篇分享文。長篇技術文件或 RFC 的 scope 聲明（「本文不討論 X」）有不同作用——幫讀者快速判斷是否繼續讀，屬合理 meta。&lt;/p></description><content:encoded><![CDATA[<h2 id="結論">結論</h2>
<p>文章中的 meta 資訊（「這篇文章的目的是…」「本文邊界是…」「先交代脈絡，否則…」）服務的是作者，不是讀者。讀者打開文章的問題是「這篇文章對我有什麼用」，而非「作者為什麼寫這篇文章」。</p>
<h2 id="案例">案例</h2>
<h3 id="案例一整理目的-blockquote">案例一：整理目的 blockquote</h3>
<table>
  <thead>
      <tr>
          <th>版本</th>
          <th>內容</th>
      </tr>
  </thead>
  <tbody>
      <tr>
          <td>修正前</td>
          <td><code>&gt; **整理目的**：這不是一次性事件的檢討報告，而是對「工具設計者的責任邊界」的反思。</code></td>
      </tr>
      <tr>
          <td>修正後</td>
          <td>（整段刪除，改為直述讀者能帶走什麼）</td>
      </tr>
  </tbody>
</table>
<p>「整理目的」告訴讀者作者為什麼寫這篇文章。但讀者的問題不是「你為什麼寫」，而是「我為什麼要讀」。兩者的差別：</p>
<ul>
<li>作者視角：「這是一篇反思，不是事件報告」→ 在做分類</li>
<li>讀者視角：「讀完這篇我能改善什麼？」→ 在評估投入回報</li>
</ul>
<h3 id="案例二脈絡解釋">案例二：脈絡解釋</h3>
<table>
  <thead>
      <tr>
          <th>版本</th>
          <th>內容</th>
      </tr>
  </thead>
  <tbody>
      <tr>
          <td>修正前</td>
          <td>「先交代脈絡，否則後面的事件沒有參照點。」</td>
      </tr>
      <tr>
          <td>修正後</td>
          <td>（整句刪除，直接進入脈絡敘述）</td>
      </tr>
  </tbody>
</table>
<p>這句話是寫給自己的編輯註記——「提醒自己為什麼要寫背景段」。讀者不需要知道作者的編輯考量。章節標題（「背景：我們怎麼管理版本和工作項目」）已經告訴讀者接下來是脈絡交代。</p>
<h2 id="判斷標準">判斷標準</h2>
<p>寫完一段 meta 描述後問：<strong>這段話消失後，讀者的閱讀體驗會變差嗎？</strong></p>
<ul>
<li>「整理目的」消失 → 讀者仍然能從內文判斷這是反思而非報告 → 不會變差 → 刪除</li>
<li>「先交代脈絡」消失 → 讀者仍然會讀到脈絡段 → 不會變差 → 刪除</li>
<li>semver 背景段消失 → 讀者會在事件段卡住 → 會變差 → 保留</li>
</ul>
<p>meta 資訊的本質是「替讀者做他已經能自己做的事」。讀者能從標題和內文推斷文章類型，不需要作者顯式宣告。</p>
<h2 id="ai-寫作的傾向">AI 寫作的傾向</h2>
<p>AI 生成的文章高頻出現 meta 資訊，因為 AI 的生成過程包含「規劃→組織→寫作」三步，meta 資訊是規劃步驟的殘留——AI 把內部的推理過程（「我接下來要先交代脈絡」）外露到了文章中。</p>
<p>生成端防護：完成初稿後掃描所有 blockquote 和段首句，問「這句在描述內容還是在描述寫作過程？」描述寫作過程的句子刪除。</p>
<p><strong>場景邊界</strong>：此判斷適用於短篇分享文。長篇技術文件或 RFC 的 scope 聲明（「本文不討論 X」）有不同作用——幫讀者快速判斷是否繼續讀，屬合理 meta。</p>
]]></content:encoded></item></channel></rss>