Documentation Refactoring and Optimization

Documentation Refactoring and Optimization

本技能提供文件結構重組與優化的原則與模式，確保文件具備清晰的內容結構、集中的主題論述，以及流暢的讀者體驗。

核心目標

• 主題連貫性 (Topic Coherence)：相關內容連續呈現，不受無關內容中斷
• 階層一致性 (Hierarchy Consistency)：正確的標題層級與父子關係
• 閱讀流程優先 (Reading Flow Priority)：以讀者理解為優先的內容組織
• 雙語標題格式 (Bilingual Title Format)：中英文合併單行，避免空章節
• 術語保留原則 (Preserve Technical Terms)：維護技術術語的可搜尋性與精確性

核心原則: 主題集中與閱讀流程優先原則 (Topic Coherence & Reading Flow Priority)

主題集中原則 (Topic Coherence)

規則： 與同一主題直接相關的所有內容必須連續呈現，不得被無關內容中斷。

範例：

<!-- ✅ 正確：主題集中 -->
├── 伺服器啟動腳本
│   ├── 伺服器啟動參數
│   ├── 伺服器啟動限制
│   ├── 瀏覽器互動測試
│   └── 伺服器管理工具  ← 輔助工具置於相關內容之後
└── 開發工具
    ├── php.bat
    └── php-test.bat

<!-- ❌ 錯誤：主題被中斷 -->
├── 伺服器啟動腳本
├── 開發工具           ← 錯誤：打斷了伺服器主題
│   ├── 伺服器啟動參數   ← 錯誤：應緊接伺服器主題