MDN Web Docs のリポジトリー

MDN Web Docs は、たくさんの変化する部分がある複雑なプロジェクトです。プロジェクトの様々なリポジトリーに慣れることはよい考えです。この文書は、MDN Web Docs プロジェクトの様々な部分に協力する際に必要となる、様々な形のリポジトリー (repos) を探す手助けをするためのものです。

リポジトリーの階層

第 1 階層

これらのリポジトリーにあるコードは、MDN Web Docs プロジェクトの中核であり、Mozilla が所有するドメイン上で実行されます。

第 1 階層のプロジェクトは、少なくとも 3 名のメンバーを有し、そのうち少なくとも 2 名は管理者権限を有している必要があります。

第 2 階層

これらのリポジトリーは、主にサンプルコード、MDN Web Docs 学習領域、ローカライズ、サンプルプロジェクトなどの対応するコンテンツに集約されています。例として次のようなものが挙げられます。

第 2 階層のプロジェクトは、少なくとも 2 名のメンバーを有し、その中には少なくとも 1 名の管理者権限を持つメンバーがいる必要があります。

第 3 階層

プロジェクトの計画、プロジェクト自体やコミュニティへの参加に関するドキュメント化です。例として次のようなものが挙げられます。

第 3 階層のプロジェクトは、 1 名の管理者が必要です。

コアリポジトリー

コアコンテンツ: https://github.com/mdn/content。 MDN Web Docs のコンテンツで最も重要なリポジトリーです。 — ここには、サイトの中核となる英語のコンテンツがすべて保存されており、ページコンテンツの標準的な変更はすべてここで行われます。
MDN Web Docs プラットフォーム: https://github.com/mdn/yari。これは、 MDN Web Docs プラットフォームが保存されている場所であり、高次元のページ構造やレンダリングの仕組みに変更を加えたい場合に行く場所です。
ブラウザー互換性データ: https://github.com/mdn/browser-compat-data。ここには、リファレンスページに掲載されているブラウザーの互換性テーブルを生成するためのデータが保存されています (例)。もしあなたがウェブ機能のブラウザーの互換性に関する情報を保有している、あるいは調査や実験をする意思と能力があるならば、MDN のブラウザー互換性データの更新に協力することができます。
インタラクティブ例: https://github.com/mdn/interactive-examples。このリポジトリーには、レンダリングコードとサンプルコードブロックが格納されています。これらは、多くのリファレンスページ (例) の上部にある、編集やコピーが可能な素敵な例を生み出します。これらの例はその場で編集できます。
Bob 別名 Builder of Bits: https://github.com/mdn/bob このリポジトリーは、私たちの多くのリファレンスページの先頭で得られる、編集可能でコピー可能な良い例を生成するレンダリングコードを格納されます (例)。
翻訳コンテンツ: https://github.com/mdn/translated-content。ここは、ローカライズされたコンテンツのための場所です。活発にメンテナンスされているロケールのいずれかにページを翻訳するのを協力したいなら、ここで行ってください。
ワークフロー: https://github.com/mdn/workflows MDN Web Docs リポジトリーで使用するための再利用可能な GitHub Actions のコレクションが増え続けています。

MDN Web Docs の GitHub org には、膨大な数の例のリポジトリーがあります。これらは一般に独立したサンプルコードを格納し、よくページからリンクされますが、時折、{{EmbedGHLiveSample("css-examples/learn/tasks/grid/grid1.html", '100%', 700)}} のようなマクロ呼び出しを使用してページにこれらの例の一つを見かけます。

指定されたページのコードを更新する場合は、対応する例のリポジトリーも更新する必要があることを常に覚えておいてください。