從真實對話彙整的 EmDash CMS 使用者文件
將反覆出現的使用者問題對應到長篇文件與 FAQ 條目的紀錄，含發佈優先順序與編輯標準。
本頁目的
本頁記錄反覆支援對話如何轉成可長期維護的文件資產。
讓文件策略綁在觀察到的使用者摩擦上，而非內部假設。
痛點來源與文件放置
痛點 1：「我該如何從空的 EmDash 專案開始？」
**觀察到的模式：**使用者在寫程式前就需要資料夾規劃，且需要一開始就釐清的架構取捨。
**放置：**長篇指南於 docs/docs，因答案需要順序、理由與反模式分析。
對應頁面：
docs/docs/emdash-cms-project-bootstrap-and-directory-layout.mdx
痛點 2：「我能部署到 Cloudflare 免費方案嗎？到底什麼會壞？」
**觀察到的模式：**使用者能部分部署，但在功能邊界與計費用語解讀上失敗。
**放置：**分拆於 docs/docs 與 docs/faq：
- 部署實務手冊屬長篇文件
- 計費與邊界釐清屬 FAQ
對應頁面：
docs/docs/emdash-cms-cloudflare-free-tier-production-playbook.mdxdocs/faq/emdash-cms-cloudflare-pricing-and-billing-faq.mdxdocs/faq/emdash-cms-cloudflare-free-plan-limitations-faq.mdx
痛點 3：「我該在哪裡執行這些指令？」
**觀察到的模式：**指令本身常沒錯，但工作目錄脈絡錯誤。
**放置：**FAQ，因使用者需要快速診斷與簡短決策規則。
對應頁面：
docs/faq/emdash-cms-deployment-command-context-faq.mdx
痛點 4：「如何確認部署真的完成了？」
**觀察到的模式：**使用者停在路由可達，漏掉後台／資料路徑驗證。
**放置：**FAQ，採檢查清單格式與快速分診順序。
對應頁面：
docs/faq/emdash-cms-deployment-verification-and-first-login-faq.mdx
痛點 5：「Dynamic Workers 到底是做什麼的？」
**觀察到的模式：**功能名稱能理解，但安全邊界含意不理解。
放置：docs/docs 的架構指南，因為是模型說明而非一句話。
對應頁面：
docs/docs/emdash-cms-plugin-runtime-and-security-model.mdx
發佈順序與理由
建議發佈順序：
docs/faq/emdash-cms-cloudflare-pricing-and-billing-faq.mdxdocs/docs/emdash-cms-cloudflare-free-tier-production-playbook.mdxdocs/faq/emdash-cms-cloudflare-free-plan-limitations-faq.mdxdocs/docs/emdash-cms-project-bootstrap-and-directory-layout.mdx- 其餘架構與自架參考文件
排序原則：
- 先發佈混淆度最高、支援負載最大的主題
- 再發佈完整執行指南
- 最後發佈深度架構參考
維持文件可信度的編輯規則
未來新增請遵守：
- 先寫決策與邊界，再寫機制
- 每項操作包含成功訊號與失敗訊號
- 每個高影響步驟提供回滾或備援路徑
- 避免抽象形容詞，除非綁在可衡量準則上
- 為時間壓力下的營運者而寫，而非行銷語氣
維護節奏
每月用三種輸入審閱此對應表：
- 最常重複的支援問題
- 使用者回報的失敗部署模式
- 跳出率高、完成度回饋低的文件頁
若某問題在單月支援中出現超過兩次，應改進現有頁面的診斷內容，或新增針對性 FAQ 條目。