MDN Web Docs 角色和團隊

MDN Web Docs 專案的成功和發展,在很大程度上歸功於我們的貢獻者社群。一些貢獻者投入了一部分時間來協助處理 MDN Web Docs 的日常任務。網站的變更,包括維護任務,由員工、承包商以及致力於 MDN Web Docs 健康、發展和維護的合作伙伴網路共同完成。該專案嚴重依賴 角色團隊GitHub 上的 MDN 組織 中管理和整合來自這些不同群體的變更。可以在 github.com/orgs/mdn 找到組織當前成員的列表。

社群貢獻對這個開源專案幫助巨大。貢獻者可以在 MDN Web Docs 上展示他們的寫作、技術和協作技能,以及與來自不同背景的人合作的能力。本節描述了在 MDN Web Docs 專案中志願服務時可以承擔的角色。

角色

在 MDN Web Docs 專案中,您可以扮演 貢獻者組織成員維護者所有者 的角色。從一個角色到下一個角色的進展是一個循序漸進的過程。隨著您責任的增加,您可能同時擔任多個角色。如果您在特定領域展示了專業知識,可以直接獲得 受邀專家 等角色。

無論您在這個專案中扮演什麼角色,您始終是 貢獻者貢獻者 是基礎角色,所有其他角色都建立在此之上。因此,在以任何身份參與此專案時,您都必須滿足貢獻者角色的要求。

貢獻者

貢獻者,或稱社群參與者,透過他們的時間、技能、意見和想法為專案做出貢獻。貢獻者直接參與專案併為其增加價值。除了編寫和測試程式碼,貢獻還包括建立和更新文件、研究、修復錯誤以及幫助其他社群成員。

根據您貢獻的頻率,您可以是偶爾貢獻的人,也可以是活躍的貢獻者。如果您對專案產生了巨大影響,您可能會被提名為 焦點貢獻者 或晉升為 組織成員

如果您是新手,並希望成為貢獻者,請檢視我們的 入門指南MDN GitHub 組織中的倉庫

作為貢獻者,您可以透過以下活動參與專案:

  • 交流渠道 上參與社群討論。
  • 幫助其他貢獻者處理他們的拉取請求和問題,或指導新貢獻者。
  • 提交錯誤報告。有關更多資訊,請檢視 主要倉庫
  • 在問題上發表評論,以促使對話達成富有成效的解決方案。
  • 透過提交 拉取請求 來解決未決問題(例如,在 content 倉庫中)。
  • 參加社群活動。
  • 幫助推廣 MDN 專案。

依賴項

要成為貢獻者,您必須遵守

  • Mozilla 的行為準則
  • 每個倉庫的具體指南。如果專案有任何特定的提示或指南,您將在專案倉庫根目錄的 CONTRIBUTING.md 檔案中找到它們。

特權

貢獻者享有以下特權:

  • 受邀參加貢獻者活動。
  • 有資格成為 組織成員

組織成員

組織成員 是定期參與並貢獻 MDN Web Docs 專案的成熟 貢獻者。他們被期望以專案的利益行事。

依賴項

要成為組織成員,您必須滿足以下一項或多項要求:

  • 已發起兩個或更多已合併的拉取請求,解決了兩個或更多問題。
  • 為 MDN Web Docs 專案貢獻至少兩個月。
  • 至少在一個專案領域積極貢獻。

以下兩項要求是強制性的:

特權

組織成員在 GitHub 上擁有 組織級別 的特權。

維護者

維護者是MDN上負責一個或多個專案的成熟貢獻者。他們被期望參與專案的政策和優先順序的決策。請參閱提名某人成為維護者的流程

作為維護者,您參與以下活動:

  • 確定您負責的專案的優先順序。
  • 參與社群會議。
  • 指導所有其他角色的新老貢獻者。
  • 根據技能集,在您的專案領域提出、批准或實施
    • 程式碼和基礎設施改進
    • 內容改進
    • 流程改進

依賴項

要符合維護者的資格,您必須滿足以下一項或多項要求:

  • 作為 受邀專家 積累了至少六個月的經驗。
  • 在多個專案領域展示了廣泛的知識。
  • 展示了獨立於其他成員的影響力,為專案利益做出判斷的能力。
  • 展現了指導其他貢獻者的品質。
  • 同意每月至少花費 16 小時在專案上。
  • 參加每兩個月舉行一次的社群會議。

注意:如果您認為某人符合此角色的資格,您可以 提名維護者

特權

維護者有權批准和合並拉取請求。

所有者

所有者擁有廣泛的許可權,可以管理使用者和 GitHub 團隊,維護 MDN 組織 中跨倉庫的訪問許可權,維護倉庫設定,以及部署到生產環境。所有者必須遵守所有其他貢獻者角色的要求。

注意:所有者角色目前僅限於 Mozilla 員工。

依賴項

除了其他貢獻者角色的職責外,所有者還承擔以下職責:

  • 遵循並執行 MDN 團隊規範,包括 社群參與指南Mozilla 政策
  • 遵循 MDN 組織政策並以身作則。
  • 透過 拉取請求流程 建議、記錄和實施新政策。
  • 關注併為 MDN 組織中的問題和討論做出貢獻。
  • 確保問題或拉取請求在一週內得到一名或多名成員的反饋。
  • 存檔 或刪除未維護的倉庫。
  • 討論 GitHub 功能,選擇要使用的功能,並記錄決策。

特權

所有者可以

  • 根據需要新增和刪除組織所有者和成員。
  • 根據需要新增和刪除特定倉庫的協作者。
  • 根據需要新增倉庫(作為新專案或轉移專案)。

角色摘要

角色 依賴項 特權
貢獻者 遵循行為準則和貢獻指南 - 邀請參加貢獻者活動
- 有資格成為組織成員
組織成員 - 為 GitHub 賬戶啟用雙重認證 (2FA)
- 啟用簽名提交

以下一項或多項:
- 解決兩個或更多問題
- 貢獻至少兩個月
- 在專案領域活躍貢獻
組織級別的訪問許可權
維護者 以下一項或多項:
- 擔任受邀專家至少六個月
- 擁有多個專案領域的知識
- 為專案的整體健康而努力
- 指導其他貢獻者
- 每月在專案上花費至少 16 小時
- 參加社群會議
批准和合並拉取請求
所有者 限於 Mozilla 員工 - 管理不同角色對各種倉庫的訪問
- 新增或歸檔倉庫和專案

特殊角色

某些貢獻者角色具有更細緻的職責和特殊的資格條件。其中包括 焦點貢獻者受邀專家社群經理

焦點貢獻者

焦點貢獻者是指在對 MDN Web Docs 的貢獻中表現出色的人。他們的貢獻形式包括透過拉取請求改進專案,在各種 交流渠道 或學習論壇上幫助社群成員,或在 GitHub 問題和拉取請求上提供反饋。

我們每月都會在 MDN 網站 上推出一位焦點貢獻者。請參閱 流程 以提名某人成為焦點貢獻者。

受邀專家

受邀專家在 MDN 上有貢獻、參與討論和評審的記錄,或在某一專業領域有經過驗證的知識。受邀專家負責 MDN 專案的特定主題領域或元件。他們負責評審和批准其主題或專案領域的拉取請求,回答技術問題,並維護其特定專案的整體健康狀況。請參閱 流程 以提名某人成為受邀專家。

除了 組織成員 的職責外,受邀專家還負責:

  • 遵循 評審指南
  • 評審其主題領域的拉取請求。
  • 幫助其他貢獻者成為評審員。

當其主題領域的拉取請求被開啟時,受邀專家會被自動分配進行評審。如果一個主題領域有多名專家,他們將使用 負載均衡策略 分配到拉取請求。

依賴項

要符合受邀專家的資格,您必須滿足以下一項或多項要求:

  • 展示了對特定主題領域的深入知識。
  • 承諾對其分配的主題領域負責。
  • 支援新貢獻者和偶爾貢獻者,並幫助他們準備好拉取請求進行合併。
  • 參加每兩個月舉行一次的社群會議。

特權

受邀專家被新增到 受邀專家團隊 和適當的主題或專案團隊。受邀專家可以:

  • 訪問所需的倉庫以進行提交、拉取請求批准和合並。
  • 推薦並投票選舉其他成員成為受邀專家。
  • 參加每週的 MDN Web Docs 編輯電話會議。

社群經理

社群經理在許多方面都扮演著獨特的角色。社群經理與 維護者 有許多相同的職責。此外,社群經理還承擔以下職責:

  • 處理違反我們 行為準則(即 Mozilla 社群參與指南)的報告,並決定適當的行動。
  • 組織和舉辦社群活動。
  • 組織與社群相關的專案會議。
  • 確定推廣 MDN 專案的媒體策略。
  • 定義和實施貢獻者入門體驗。
  • 引導新貢獻者和使用者。
  • 確保 MDN 專案和所有參與者的健康和福祉。
  • 識別並協助實施自動化以提高專案可持續性。
  • 與貢獻者和合作夥伴會面並確保健康的合作關係。
  • 酌情協助問題分類和拉取請求評審。
  • 監控所有 交流渠道
  • 表彰在 MDN 專案中做出傑出貢獻和/或表現出奉獻精神的貢獻者。

流程

提名維護者

請參閱誰可以成為 維護者

要提名某人成為維護者,請在 GitHub 上建立一個問題:

  1. mdn/mdn 倉庫的 Issues 選項卡上,點選右側的 New issue 按鈕。
  2. 在“Nominate a maintainer”(提名維護者)下,點選 Get started(開始)按鈕。
  3. 填寫表格,詳細說明您所提名人的貢獻,然後提交表格。

提名焦點貢獻者

請參閱誰可以成為 焦點貢獻者

要提名某人成為焦點貢獻者,請在 GitHub 上建立一個問題:

  1. mdn/mdn 倉庫的 Issues 選項卡上,點選右側的 New issue 按鈕。
  2. 在“提名焦點貢獻者”下,點選“開始”按鈕。
  3. 填寫表格,詳細說明您所提名人的貢獻,然後提交表格。

MDN 團隊將與被提名人聯絡,以獲取其資訊,並將其釋出在 網站 的“焦點貢獻者”部分。

提名受邀專家

請參閱誰可以成為 受邀專家

要提名某人成為受邀專家,請在 GitHub 上建立一個問題:

  1. mdn/mdn 倉庫的 Issues 選項卡上,點選右側的 New issue 按鈕。
  2. 在“提名受邀專家”下,點選“開始”按鈕。
  3. 填寫表格,詳細說明您所提名人的貢獻,然後提交表格。

卸任或申請榮譽身份

生活瞬息萬變,您作為貢獻者的承諾水平可能會隨著時間而改變。根據您的情況,您可能希望:

  • 暫時中斷專案。
  • 降級到要求較低的角色。
  • 完全退出專案(申請榮譽身份)。

在所有這些情況下,請隨時與 MDN 團隊 討論您的情況和當前的承諾水平。

降級或移除不活躍的貢獻者

當貢獻者未能履行職責和要求時,包括重複的不活躍模式或違反 行為準則 時,可以將其降級或移除。

在維護者會議期間,參與者會提出降級或移除貢獻者的建議。參與者會提供支援降級或移除請求的資訊。經過討論後,維護者和社群經理會就此事進行投票以做出決定。

移除不活躍的貢獻者可以保護專案及其成果,也為新貢獻者提供了參與的機會。

我們對不活躍的定義是:

  • 至少六個月內沒有對專案做出貢獻。
  • 至少三個月內沒有回覆溝通。

不活躍會損害專案;它可能導致意外延遲、貢獻者流失以及對專案信任的喪失。貢獻者必須保持活躍,以樹立榜樣並展現對專案的承諾。

如果您的時間承諾發生變化,請與社群團隊溝通,以避免降級或移除;相反,您可以主動選擇 暫時卸任或轉為榮譽身份

團隊

我們使用 GitHub 團隊 功能來管理團隊。當您被新增到團隊時,這意味著您已經表達了更緊密地參與專案的意願。這也意味著您擁有一些額外的職責和權利,如下所述:

  • 團隊成員通常會根據其感興趣的相應主題領域被新增到 CODEOWNERS 檔案中。

  • 當拉取請求觸及您負責的區域中的檔案時,根據 CODEOWNERS 檔案,您將使用 GitHub 的 負載均衡演算法 自動新增為拉取請求的審閱者。

  • 團隊成員擁有更高級別的倉庫訪問許可權。倉庫許可權僅分配給成員需要訪問的那些倉庫。

MDN GitHub 組織 中的團隊包括:

  • @Core:MDN Web Docs 核心團隊
  • @mdn-community-engagement:負責我們所有倉庫的社群參與人員
  • @mdn-product:負責 MDN Plus 產品的人員
  • @localization-team-leads:領導我們各個本地化團隊的人員
  • @OWD:來自開放網路文件非營利組織的貢獻者
  • @sre:支援 MDN Web Docs 的站點可靠性工程師
  • @yari-content:所有 MDN Web Docs 內容審閱者的總團隊
    • 針對不同的主題領域設有子團隊——無障礙、附加元件、CSS、HTML、HTTP、JavaScript、SVG、Web API 和 WebAssembly。例如,有 @yari-content-css@yari-content-svg
    • 還有針對不同語言的子團隊——巴西葡萄牙語、中文、法語、日語、韓語、俄語和西班牙語。例如,有 @yari-content-fr@yari-content-ko

要成為團隊成員,您必須:

聯絡 MDN 團隊

如有疑問和反饋,請聯絡 mdn-web-docs-community (at) mozilla (.com)。