在對 Mozilla 支援知識庫文章進行任何修訂之前,請務必了解,我們會根據變更的重要性,以不同的方式處理內容工作流程。
所有新文章和對支援文章的重大變更,都需要透過 Bugzilla 提交內容請求(請參閱 How to submit a SUMO Knowledge Base content request),而次要變更則可以直接在文章中提交,無需內容請求。
怎樣算是次要變更
我們認為的次要變更如下:
- 修正小錯字
- 移除不必要的空白
- 修正拼寫、文法或標點符號錯誤
- 修正 wiki 標記格式(標題、項目符號、編號、間距、縮排)
- 在不重寫章節的情況下,更新小部分的事實細節(例如:版本號、按鈕或選單標籤)
- 在不改變原文情境下,更新章節並用現有模板替換
- 修正過時或不支援的內容,包括維護性更新,例如新增或移除版本標籤,而不對基本指引做大幅變更
- 移除與不再支援的產品版本相關的內容和標記
- 透過小幅度的教學改進、簡化措辭或為無障礙使用加入視覺提示(例如:新增圖示和選單參考)來提高可讀性或清晰度,而不大幅改變指引或文章結構
- 更新失效連結、指向已更名知識庫文章的連結,或指向相同目標內容的連結
- 調整語氣以符合 Mozilla 的支援內容標準
- 將過時的 UI 螢幕截圖更換為更新版本(最多 3 張螢幕截圖)
- 更新關鍵字
- 新增或更新搜尋摘要
怎樣算是重大變更
對知識庫(KB)支援文章的重大變更,需要一份 Bugzilla 請求,以利與產品關係人協調、確保內容準確性、追蹤進度並支援跨職能合作。
以下是我們認為的重大變更:
- 建立新文章
- 需要產品關係人驗證或與其密切協調的變更,包括:
- 與版本發布準備相關的更新
- 大幅度的內容新增(例如新的說明、常見問答或疑難排解步驟)
- 更換過時的螢幕截圖或新增超過 3 張的新螢幕截圖
- 影響使用者指引或文章結構,且需要內容團隊審核的重大變更,包括:
- 移除現有章節
- 大量重寫段落或章節
- 大規模的格式或結構變更(例如重組多個章節或改變文章流程)
- 改變文章的範圍或意圖
- 更新、新增或移除螢幕錄影、GIF 或影片
- 重寫或重新命名可能影響錨點連結或文章導覽的章節標題
若要了解更多關於知識庫貢獻的資訊,請參閱 How to contribute to the Knowledge Base。