 Leo
|
3af210e03a
|
docs: 版本說明頁刪除，改連 GitHub 版本發佈（arcrun-rag#41）
leo 2026-08-17：「這個頁面刪除。」
（同一件事 08-09 就講過：「不要同步，docs 的版本說明直接連回 github 的版本發佈」，
那時記在該檔檔頭當待辦，理由是「等 releases 累積出足夠版本歷史」——現有 9 筆，理由失效。）
使用者要看版本紀錄 → github.com/youlinhsieh/arcrun-rag/releases。文件站不再自己維護一份。
── 🔴 動手前發現的事：那一頁不只是一頁 ──────────────────────────────
`docs-site/src/content/docs/help/changelog.md` **同時是兩個東西**——文件站的一頁，
以及**雲端引擎 `1.4.x` 的出貨原稿**（`installer/scripts/daemon-notes.mjs` 的 `CHANGELOG_REL`，
被 `ship.mjs` 的 docs-changelog／release-record 與 `github-release.mjs` 讀）。
直接 `rm` 會讓雲端那條線的 GitHub／Gitea 版本發佈點進去變空白。
⇒ 頁面刪掉，**原稿搬去 repo 根的 `CHANGELOG.md`**（旁邊就是根的 `RELEASE_LINE`），
形狀與桌面版那條線一致：`collector/CHANGELOG.md` ＋ `collector/DAEMON_LINE`。
`collector/CHANGELOG.md` 一個字都沒動。
── 投影機制整套拆掉（0fb72ae，D95 第四輪，昨天才併進 main）──────────
它存在的唯一理由是把 daemon 段落渲染回這一頁。頁面沒了，它就是沒人用的機制：
· `docs-site/remark-daemon-changelog.mjs`（整支）
· `astro.config.mjs` 的 import 與 `markdown.remarkPlugins`
· `package.json` build 的 `--force`（那是投影的必要條件，不是通用旗標）
· `collector/.../daemon-notes.mjs` 的 `releasedSections()`／`releasedSectionsFromFile()`／`RELEASED_HEADING`
· `collector/.../daemon-notes.test.mjs`（4 支全是投影的演練）
`daemon-notes.mjs` 其餘匯出（notesForVersion／checkNotes…）是出貨線在用的，留著。
── 舊網址留一條轉址，不直接 404 ──────────────────────────────────
那個網址掛在側欄上、也印在 landing「這一版改了什麼」旁邊，已隨 landing 部署到使用者
瀏覽器裡。repo 內的連結本輪都改成直接指 GitHub（landing／docs 首頁／側欄），
所以轉址不服務任何內部連結，只接書籤與舊 HTML。它是 `astro.config.mjs` 的一行宣告
（沒有程式、沒有真相源可以漂），而且被 verify-docs 每次出貨夾住 ⇒ 不是要維護的機制。
── ⚠️ 一次真的降級，標在這裡不藏 ────────────────────────────────
`verify-docs.mjs` 原本斷言「線上那一頁有這兩個版號」——沒有頁面就沒有東西可查。
改成斷言「那條轉址還在」（＝線上這顆確實是這份原始碼建的）。
**舊斷言抓得到「內容停在上一版」，新斷言抓不到。** 差額由 `release-record` 站承接：
每條版本線都要有一筆版本發佈、內文抽不到就中止——那一站有牙齒且更早跑。
`docs` 站的 ① 那道「這一版寫了嗎」照舊每個目標都問（D65：不准跳）。
實測
· 建置產物：`1.4.4x`／`v0.18.2x` 命中 0 個檔；`dist/help/changelog/index.html`
＝轉址頁（meta refresh＋canonical＋a href 全指 releases）
· 兩種網址（astro preview）：`/docs/help/changelog` 與 `…/changelog/` 皆 200，
內容同一份轉址頁，版本號命中各 0
· 站內死連結：指向該網址的 href 0 條；pagefind 11 個 fragment 含 changelog 者 0；sitemap 未列
· 產生鏈完整：`1.4.47`→根 CHANGELOG.md（摘要＋4 行內文）／`v0.18.29`→collector/CHANGELOG.md
（摘要＋6 行內文）／`1.4.29`→根（6 行）；不存在的版號回 null
· `node --test installer/scripts/*.test.mjs` 233 支全綠
（238→233：-4 投影演練、-1 htmlText，兩者的實作都已移除）
· 建置那句 `/404.htmlEntry docs → 404 was not found.` 是既有行為——
拿掉 redirects 重建仍出現，與本輪無關
Refs: inkstone/arcrun-rag#41
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
|
2026-08-18 14:35:25 +08:00 |
|