D-20260818-03|文檔站首頁狀態與精簡導覽¶
背景與驅動力¶
原有靜態站會在所有頁面重複投影 lifecycle phase、更新時間與 specs commit;導覽中的分類名稱也 反覆出現在每個子頁標題,只有 README 的子分類則形成兩層同名選單。這些資訊雖可稽核,但沒有 提升內頁判讀,反而增加視覺噪音;specs repo 重建後,舊 commit 標籤亦沒有產品契約價值。
考慮過的選項¶
- 保留全站 banner、只移除 commit:仍會在每頁重複相同生命週期資訊,未解決主要問題。
- 完全移除開發狀態:可能讓公開文檔被誤認為正式 runtime 相容承諾,不採用。
- 首頁一句狀態、生命週期檔承接細節:保留必要告知,並讓內頁與導覽聚焦內容,採用。
決定¶
總覽.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 或發布順序。