微小變更與重大變更

貢獻者 貢獻者 最近更新: 3 週前
This is a machine-generated translation of the English article. It has not been reviewed by a human, and may contain errors. If you would like to revise this content, you can start here.

在對 Mozilla 支援知識庫文章進行任何修訂之前,請務必了解,我們會根據變更的重要性,以不同的方式處理內容工作流程。

所有新文章和對支援文章的重大變更,都需要透過 Bugzilla 提交內容請求(請參閱 How to submit a SUMO Knowledge Base content request),而次要變更則可以直接在文章中提交,無需內容請求。

怎樣算是次要變更

指導原則: 次要更新不會大幅改變文章的指引、疑難排解方向、結構或意圖,且通常不需要產品驗證或與產品關係人進行更廣泛的協調。

我們認為的次要變更如下:

  • 修正小錯字
  • 移除不必要的空白
  • 修正拼寫、文法或標點符號錯誤
  • 修正 wiki 標記格式(標題、項目符號、編號、間距、縮排)
  • 在不重寫章節的情況下,更新小部分的事實細節(例如:版本號、按鈕或選單標籤)
  • 在不改變原文情境下,更新章節並用現有模板替換
  • 修正過時或不支援的內容,包括維護性更新,例如新增或移除版本標籤,而不對基本指引做大幅變更
  • 移除與不再支援的產品版本相關的內容和標記
  • 透過小幅度的教學改進、簡化措辭或為無障礙使用加入視覺提示(例如:新增圖示和選單參考)來提高可讀性或清晰度,而不大幅改變指引或文章結構
  • 更新失效連結、指向已更名知識庫文章的連結,或指向相同目標內容的連結
  • 調整語氣以符合 Mozilla 的支援內容標準
  • 將過時的 UI 螢幕截圖更換為更新版本(最多 3 張螢幕截圖)
  • 更新關鍵字
  • 新增或更新搜尋摘要
注意: 我們希望將小幅變更合併在單一修訂中提交,而不是分成多個修訂。

怎樣算是重大變更

指導原則: 重大更新是會大幅影響使用者指引、文章結構、在地化影響,或需要與內部或外部關係人進行跨職能協調的變更。

對知識庫(KB)支援文章的重大變更,需要一份 Bugzilla 請求,以利與產品關係人協調、確保內容準確性、追蹤進度並支援跨職能合作。

注意: 如果變更的技術驗證已存在於 Mozilla 的公開文件中,例如 Bugzilla、版本日誌或部落格文章,且不需要額外的產品意見,則通常無需建立 Bugzilla ticket,除非該內容與版本發布準備有關。

以下是我們認為的重大變更:

  • 建立新文章
  • 需要產品關係人驗證或與其密切協調的變更,包括:
    • 與版本發布準備相關的更新
    • 大幅度的內容新增(例如新的說明、常見問答或疑難排解步驟)
    • 更換過時的螢幕截圖或新增超過 3 張的新螢幕截圖
  • 影響使用者指引或文章結構,且需要內容團隊審核的重大變更,包括:
    • 移除現有章節
    • 大量重寫段落或章節
    • 大規模的格式或結構變更(例如重組多個章節或改變文章流程)
    • 改變文章的範圍或意圖
    • 更新、新增或移除螢幕錄影、GIF 或影片
    • 重寫或重新命名可能影響錨點連結或文章導覽的章節標題
注意: 為使審核過程更易於管理,重大變更應作為獨立的修訂版本提交。如果以單一大型修訂版本提交,您的修訂可能會被延後,並被要求將其拆分成較小的部分後重新提交。

若要了解更多關於知識庫貢獻的資訊,請參閱 How to contribute to the Knowledge Base。

這些好人幫助我們撰寫了這篇文章:

Illustration of hands

成為志工

在此回答問題並幫助我們改善知識庫內容,與其他人一起切磋琢磨專業能力。

了解更多