跳轉到

發布前檢查清單

摘要

本頁提供發布到 AI知識庫網站前的檢查清單,協助避免敏感資料外洩、導覽錯誤與建置失敗。

適用情境

  • 新增或修改 docs/ 文章。
  • 更新 mkdocs.yml nav。
  • 部署到 Cloudflare Pages 或 GitHub Pages 前。

檢查清單

內容分級

  • 本文已確認為 Public / 可公開。
  • 沒有 Internal、Confidential 或 Restricted 內容。
  • 不確定資訊已標示「待確認」。

保密與個資

  • 沒有 API keys、tokens、passwords 或 private keys。
  • 沒有 .env、credentials 或憑證內容。
  • 沒有學生資料、個人資料、受訪者資料或第三方私人資訊。
  • 沒有未公開研究資料、投稿內容或審稿資料。

文章品質

  • 每頁只有一個 H1。
  • 標題層級清楚。
  • 段落短而可讀。
  • 指令、檔名與路徑使用 inline code。
  • 相關頁面連結有效。

導覽與建置

  • 新頁面已加入 mkdocs.yml nav。
  • nav 沒有暴露 private/drafts/secrets/ 或本機路徑。
  • 已執行或準備執行 mkdocs build --strict

注意事項

若任一項未通過,請先修正再部署。

相關頁面

更新紀錄

  • 2026-07-02:建立完整初始版。