MDN Web Docs の役割とチーム
MDN Web Docs プロジェクトの成功と発展は、大部分において、私たちの協力者コミュニティによるものです。協力者の中には、 MDN Web Docs を実行するための日々の作業を支援するために、自分の時間の一部を割いてくれていzる方もいます。メンテナンス作業を含むサイトの変更は、社員、請負業者、パートナーのネットワークによって行われますが、彼らはすべて MDN Web Docs の健全性、成長、メンテナンスに専念しています。プロジェクトは、これらの異なる形のグループからの変更を管理し取り入れるために、GitHub の MDN の組織 の 役割 と チーム に強く依存しています。この組織メンバーのリストは ここに掲載されています。
コミュニティの貢献は、このオープンソースプロジェクトに大いに役立っています。 協力者は、 MDN Web Docs での作業によって、文章力、技術力、協調性、そして多様な背景を持つ人々と一緒に作業する能力を示すことができます。この章では、 MDN Web Docs プロジェクトでボランティアとして参加する際に、あなたが担うことのできる役割について記述します。
役割
MDN Web Docs プロジェクトでは、協力者、組織メンバー、メンテナー、オーナーの役割を担うことができます。ある役割から次の役割への進行は、一歩一歩の旅です。 責任範囲が広がれば、同時に複数の役割を果たすことも可能です。特定の分野で専門性を発揮すれば、招待された専門家などの役割を直接得ることができます。 招聘専門家などの役割は、具体的な分野で専門性を発揮していれば、直接獲得することが可能です。
このプロジェクトで自分がどのような役割を担っているかに関わらず、あなたは常に協力者なのです。 協力者は基本ロールであり、他のすべてのロールはその上に構築されます。 という具合に、自分のプロジェクトで作業している間は、どのような立場であれ、あなたは貢献者の役割の要件を満たす必要があります。
協力者
協力者(コミュニティ参加者)は、自分の時間、スキル、意見、アイディアなどを使ってプロジェクトに追加します。 協力者は直接プロジェクトに作業し、プロジェクトに価値を加えます。 コードを書いたりテストしたりする以外に、文書の作成や更新、調査、バグの修正、他のコミュニティメンバーの手助けをすることも含まれます。
協力の頻度によって、たまに協力する人、積極的に協力する人のどちらにもなれます。 自分のプロジェクトに大きな影響を与えた場合、スポットライト協力者として推薦されたり、組織メンバーに昇格することがあります。
もしあなたが初めてここに来て、協力者になりたいと思ったら、協力ガイド と MDN の GitHub 組織内のリポジトリーに目を通してみてください。
以下のような活動に従事することで、協力者としてプロジェクトに参加することができます。
- コミュニケーションチャンネルで、コミュニティの議論に参加する。
- 他の協力者のプルリクエストや 課題を支援したり、新しい協力者に指導したりする。
- バグ報告を送信する。MDN の
content
リポジトリーで開くことのできる課題の種類を調べてください。 プラットフォームのバグに気がついたら、MDN のyari
リポジトリーで課題を開くことができます。 - 実りある解決に向けて会話を進めるために、課題についてコメントすること。
- (
content
リポジトリーなどで)未解決の課題に対して、プルリクエストを送信して対応する。 - コミュニティイベントに参加する。
- MDN プロジェクトの広報に協力する。
要件:
協力者になるには、以下に従ってください。
- Mozilla の行動規範
- 協力ガイドライン(各リポジトリーの
CONTRIBUTING.md
ファイルを調べてください。例えば、これはmdn/content
リポジトリーの 協力ガイドライン です)。
権限:
協力者は以下の権限が得られます。
- 協力者イベントへの招待。
- 組織メンバーになるための資格。
組織メンバー
メンテナー
メンテナーは、MDNで 1 つまたは複数のプロジェクトに責任を持つ確立された協力者です。 自分のプロジェクトの方針と優先順位の決定に参加することが期待されています。誰かをメンテナーに推薦するプロセスをご覧ください。
メンテナーとして、以下のような活動を行います。
- 自分の担当するプロジェクトの優先順位を決定する。
- コミュニティミーティングに参加する。
- 他のすべての役割にまたがる新規および既存の協力者を指導する。
- スキルセットに基づいて、自分のプロジェクト領域で提案、承認、実装を行う。
- コードおよびインフラの改善
- コンテンツの改善
- プロセスの改善
要件:
メンテナーになるには、以下の条件のうち 1 つ以上を満たす必要があります。
- 招聘専門家として 6 ヶ月以上の経験を積んでいること。
- 自分のプロジェクトについて、複数の分野にまたがる幅広い知識を示している。
- 自分のプロジェクトのために、他のメンバーの影響に左右されない判断力を発揮できることを示している。
- 他の協力者を指導する資質があることを示している。
- 自分のプロジェクトに月 16 時間以上作業することに同意していること。
- 2 ヶ月に 1 度開催されるコミュニティミーティングに参加している。
メモ: この役割にふさわしいと思う人がいれば、メンテナーを推薦することができます。
権限:
メンテナーは、プルリクエストを承認したりマージしたりする権限があります。
オーナー
オーナーは、ユーザーと GitHub チームの管理、MDN 組織内のリポジトリーへのアクセスの管理、リポジトリー設定の管理、本番環境への展開など、幅広い権限を持ちます。 オーナーは、他の協力者ロールのすべての要件に拘束されます。
メモ: オーナーの役割は、現在は Mozilla スタッフに限定されています。
要件:
他の協力者としてのレスポンスに加え、オーナーは以下のような責任を持ちます。
- コミュニティ参加ガイドラインやMozilla ポリシーを含む MDN チームの規約に従い、遵守すること。
- MDN 組織の方針に従い、自ら例を示してリードすること。
- プルリクエストプロセスを通して新しいポリシーの提案、文書化、実装を行うこと。
- MDN 組織全体の課題やディスカッションに従い、協力すること。
- 課題またはプルリクエストが 1 週間以内に 1 人以上のメンバーからフィードバックを取得することを保証すること。
- 保守されていないリポジトリーをアーカイブまたは削除すること。
- GitHub の機能について議論し、使用するものを選択し、決定事項を文書化すること。
権限:
オーナーは以下のことを実行できます。
- 必要に応じて組織のオーナーやメンバーを追加したり、削除したりすることができます。
- 必要に応じて、特定のリポジトリーに共同作業者を追加したり、削除したりすることができます。
- 必要に応じてリポジトリーを(新規プロジェクトまたは移譲として)追加ことができます。
役割の概要
役割 | 要件 | 権限 |
---|---|---|
協力者 | 行動規範と協力ガイドラインに従うこと | - 協力者イベントへの招待 - 組織メンバーになるための資格 |
組織メンバーr | - GitHub アカウントで 2FA を有効にする - 署名付きコミットを有効にする 次のうち 1 つ以上: - 2 つ以上の課題を解決する - 2 ヶ月以上の貢献 - 一つのプロジェクト領域における積極的な貢献 |
組織レベルのアクセス権 |
メンテナー | 次のうち 1 つ以上: - 6 ヶ月以上の招聘専門家の経験 -複数の自分のプロジェクト領域にわたる知識 - プロジェクト全体を健全にするための行動 - 他の協力者を指導する - そのプロジェクトに月 16 時間以上費やしていること - コミュニティミーティングに参加していること |
プルリクエストの承認とマージ |
オーナー | Mozillaのスタッフに限定 | - 様々なリポジトリーに対する様々な役割のアクセスを管理する - リポジトリーやプロジェクトを追加したりアーカイブしたりする |
特殊なロール
協力者の中には、より繊細な責任を負い、特別な資格条件があるものもあります。これには、スポットライト協力者、招聘専門家、コミュニティ管理者などが挙げられます。
スポットライト協力者
スポットライト協力者は、MDN Web Docs への貢献以上の成果を上げた人たちです。 この貢献は、プロジェクトを改善するためのプルリクエスト、様々なコミュニケーションチャネルや 学習フォーラムでのコミュニティメンバーの支援、GitHub の課題やプルリクエストにフィードバックするなどの類のものです。
MDN ウェブサイトでは、毎月 1 回、スポットライト協力者の特集を組んでいます。 スポットライト協力者として誰かを推薦するには、そのプロセスをご覧ください。
招聘専門家
招聘専門家は、MDN で貢献、ディスカッションやレビューへの参加などの実績を有しているか、あるいは特定の専門分野における知識が実証されている人です。 招聘専門家は、特定のトピック領域で、または MDN プロジェクトのコンポーネントを担当します。 彼らは、自分のトピックやプロジェクト領域のプルリクエストをレビューして承認し、技術的な質問に答え、自分の特定のプロジェクトの一般的な健全性を維持する責任を負います。招聘専門家として誰かを推薦するプロセスを参照してください。
招聘専門家は、組織メンバーの責任に加え、以下の責任を負います。
- レビューガイドに従う。
- 自分のトピック領域でプルリクエストされたものをレビューする。
- 他の協力者がレビュアーになるのを支援する。
招聘専門家は、そのトピック領域でプルリクエストが開かれたときに、自動的にレビューが割り振られます。 あるトピック領域に複数のエキスパートがいる場合、負荷分散戦略を使用して、プルリクエストが割り当てられます。
要件:
招聘専門家として認定されるには、以下の要件のうち 1 つ以上を満たす必要があります。
- 特定のテーマ領域について深い知識を示している。
- 割り当てるトピック領域に対して責任を持つことを約束する。
- 新規および時々の協力者を対応し、プルリクエストをマージできるようになるまで支援する。
- 2 ヶ月に 1 度開催されるコミュニティミーティングに参加する。
権限:
招聘専門家は、招聘専門家チームと適切なトピックまたはプロジェクトチームに追加されます。招聘専門家は以下のことが可能です。
- コミットやプルリクエストの承認やマージに必要なリポジトリーにアクセスできる。
- 他のメンバーを招聘専門家に推薦し、投票する。
- 毎週行われる MDN Web Docs の編集会議に参加する。
コミュニティマネージャー
コミュニティ管理者は、多くの点で明確な役割があります。 コミュニティ管理者は、メンテナーと同じ責任の多くを共有します。さらに、コミュニティ管理者には以下のような責任があります。
- Mozilla のコミュニティ参加ガイドライン である行動規範違反の報告に対処し、適切な措置を決定すること。
- コミュニティイベントの企画・運営。
- コミュニティに関するプロジェクトに関連する会議の開催。
- MDN プロジェクトを推進するためのメディア戦略の決定。
- 協力者の受け入れ体制を定義し、実装すること。
- 新しい協力者やユーザーの受け入れ。
- MDN プロジェクトとすべての参加者の健康と幸福を保証すること。
- プロジェクトの持続可能性を向上させるための自動化を特定し、実装するために支援すること。
- 協力者やパートナーと話し合い、健全な関係を維持すること。
- 課題のトリアージやプルリクエストのレビューを適宜支援する。
- すべてのコミュニケーションチャンネルをモニタリングする。
- MDN プロジェクトに卓越した作業をしたり、献身的な姿勢を示したりした協力者に光を当てる。
手続き
メンテナーの推薦
スポットライト協力者の推薦
誰がスポットライト協力者になれるかを確認してください。
誰かをメンテナーに推薦するには、次にように GitHub で課題を開いてください。
mdn/mdn
リポジトリーのIssues
タブで、右側の New issue ボタンをクリックします。- 'Nominate a spotlight contributor' の下にある Get started ボタンをクリックしてください。
- フォームに推薦する人の貢献度を詳細に記入し、フォームを送信してください。
MDNチームは、推薦された方と連絡を取り、その情報をウェブサイトの "Contributor Spotlight " で公開するよう準備します。
招聘専門家の推薦
退任または名誉職の申請
人生は常に変化しており、協力者としてのコミットメントレベルも時刻とともに変化する可能性があります。あなたの状況に応じて、次のことをお勧めします。
- 自分のプロジェクトから一時的に離れてみる。
- 要求の少ない職務に格下げする。
- 自分のプロジェクトから完全に手を引く(名誉職の申請をする)。
これらのどのような状況でも、あなたの状況や現在のコミットレベルを MDN チームに自由に相談してください。
活動休止中の協力者の降格・削除
協力者は、度重なる活動停止や行動規範の違反など、責任や要件が満たされていない場合、降格や削除されることがあります。
協力者の降格または解任は、メンテナー会議中に参加者から提案されます。 参加者は降格または解任のリクエストに対応した情報を提供します。 ディスカッションの後、メンテナーとコミュニティ管理者はその件について投票を行い、決定を下します。
活動休止中の協力者を削除することは、自分のプロジェクトとその成果物を保護し、また新しい協力者が入ってくるための機会を開くことになります。
私は活動休止を次のように定義しています。
- 6 か月以上、そのプロジェクトへの貢献がない。
- 3 か月以上、連絡に反応がない。
活動休止はプロジェクトに悪影響を及ぼします。予期せぬ遅延、協力者の減少、プロジェクトに対する信頼の喪失につながる可能性があります。協力者は積極的に行動することで、模範となり、プロジェクトに対するコミットメントを示す必要があります。
コミュニティチームと連絡を取り合い、時間的な制約が変わった場合に降格や解任を避けるため、代わりにしばらく身を引くか、名誉職に移る という選択を積極的に行うようにしてください。
チーム
私たちは、GitHub teams という機能を使ってチームを管理しています。あなたがチームに追加されたということは、あなたがより密接にプロジェクトに関与する意思を伝えたということです。これはまた、下記に説明するように、いくつかの追加的な責任と権利を持つことを意味しています。
-
チーム内の人物は、それぞれの関心分野の CODEOWNERS ファイルに共通に追加されます。
-
自分の担当分野のファイルにプルリクエストが行われると、CODEOWNERS ファイルに基づき、GitHub の負荷分散アルゴリズムを用いて自動的にプルリクエストのレビュアーとして追加されます。
-
チームのメンバーは、より上位のリポジトリーへのアクセス権を持ちます。リポジトリーへのアクセス権は、メンバーがアクセスを必要とするリポジトリーのみに割り当てられます。
GitHub の MDN 組織に所属するチームには、以下のようなものがあります。
-
@Core
: MDN Web Docs チームのコアメンバー -
@mdn-community-engagement
: リポジトリー全体のコミュニティ参加を担当する人々 -
@mdn-product
: MDN Plus 製品の担当者 -
@localization-team-leads
: 個々のローカライズチームを率いる人々 -
@OWD
: 非営利団体 Open Web Docs の協力者たち -
@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
があります。
- アクセシビリティ、アドオン、CSS、HTML、HTTP、JavaScript、SVG、Web API、WebAssembly といった様々なトピック領域に対してサブチームが存在します。例えば、
チームのメンバーになるには、以下のことが必要です。
- コミュニティ参加ガイドラインを遵守することに同意すること。
- Mozilla のコミットメントアクセス要件に同意すること。
- GitHub アカウントで 2 要素認証 (2FA) を設定すること。
MDN チームへの連絡
お問い合わせやご意見は、 mdn-web-docs-community (at) mozilla (.com) までお願いします。