跳轉到

D-20260818-03|文檔站首頁狀態與精簡導覽

背景與驅動力

原有靜態站會在所有頁面重複投影 lifecycle phase、更新時間與 specs commit;導覽中的分類名稱也 反覆出現在每個子頁標題,只有 README 的子分類則形成兩層同名選單。這些資訊雖可稽核,但沒有 提升內頁判讀,反而增加視覺噪音;specs repo 重建後,舊 commit 標籤亦沒有產品契約價值。

考慮過的選項

  1. 保留全站 banner、只移除 commit:仍會在每頁重複相同生命週期資訊,未解決主要問題。
  2. 完全移除開發狀態:可能讓公開文檔被誤認為正式 runtime 相容承諾,不採用。
  3. 首頁一句狀態、生命週期檔承接細節:保留必要告知,並讓內頁與導覽聚焦內容,採用。

決定

  • 總覽.md 以一般內文明示「開發中/主遊戲尚未正式公開」,並連到 專案生命週期.md;內頁 不再顯示 lifecycle banner、更新時間或 specs commit。
  • 子頁 H1 不重複其父分類名稱;程式流程/ 內的頁名不再附加「流程圖/技術流程圖」。若標題 本身需區分圖的種類(例如 Signaling Service 架構圖),可保留具辨識力的類型。
  • 只有一個 README 的子分類在導覽中攤平,避免 Immutable Release → Immutable Release
  • Conformance 測試向量知識圖 提升到首頁之後,優先呈現可驗證契約與跨 repo 導航。
  • runtime_phase、轉換依據與相容規則仍以 專案生命週期.md 為唯一權威;exact revision 與 更新稽核由 Git 歷史保存。

後果與影響

靜態站首頁仍能避免公開階段誤解,但內頁不再依賴生成時的 repository metadata。導覽較短且 不重複分類語意;conformance 與知識圖更容易找到。此變更只調整文檔呈現,不改產品契約、 runtime phase 或發布順序。