私たち MDN は、ブランドやブラウザ、そしてプラットフォームを問わず、より良い Web へ向けたリソースを構築する開発者やライターたちからなるオープンコミュニティです。誰でも貢献でき、それぞれの貢献によってコミュニティはより強固なものとなります。ともに協力することで、Web をより良いものへ革新していく後押しを継続させることができます。すべてはここから始まります、そう、そこのあなたも。
MDN の全ての要素(このサイトを機能させているコードや、文書、コードサンプル、そしてデモ)はオープンな開発者コミュニティにより作成されています。どなたでも何らかの形で貢献できますので、ぜひあなたのご参加をお待ちしています!
MDN 参加の簡単な 3 ステップ
MDN は wiki であり、誰でもコンテンツを追加、編集できます。プログラマであったり、テクノロジーについて多くを知っている必要はありません。校正や誤植の修正などの簡単なことからAPI ドキュメントの作成のような複雑なことまで、行うべき事はたくさんあります。
貢献するのは簡単で危険を伴いません。間違ってしまった場合でも、簡単に修正できます。出来栄えをどうすべきかわからなかったり、文法が完璧でなかったりしても、気にしないで! MDN にあるコンテンツの品質チェックを担当するチームがあります。誰かがやってきて、あなたの成果がきちんと丁寧に書かれているかどうか確認してくれます。あなたの知識を共有し、長所を活かし、そしてあなたの成果をさらに高めてくれるコミュニティの仲間たちを信頼しましょう。
ステップ 1 : MDN のアカウントを作成する
MDN への貢献を開始するには、MDN のアカウントが必要です。詳細は「MDN アカウントを作成するには」をご覧ください。
ステップ 2 : 完成させるタスクを選ぶ
ログインしたら、下記リスト内の、色々なタスクの種類についての説明を読んで、最もやってみたいものを決めましょう。お好きなタスクを選択し、貢献を開始することができます。
ステップ 3 : タスクを行う
やってみたいタスクを決めて、作業対象とする特定のページや、コード例などを探したら、あとはただやってみましょう!
完璧にしようと悩まないで。MDN に貢献している他の方々が、見落とした間違いの修正を手伝ってくれます。進めていくにつれ疑問がわいたら、回答を得られるメーリングリストやチャットチャンネルについての情報が載っているコミュニティに関するページをご覧ください。
注記 : MDN の編集を「実際に」行う前に体験してみたい場合は、編集を試したい人向けのサンドボックスページがあります。試行錯誤はそのページ内に留めるようにしてください。何が起きるのかを知るためだけに不要な変更をしないでください。そうした結果、他の方が後始末をするはめになります。
選んだタスクを終えたら、自由に他の項目を選ぶか、あるいは下記にある「その他の MDN で行える事」をご覧ください。
貢献できるタスクの種類
あなたの持つスキルや興味に適した、MDN に貢献できる複数の方法があります。中には怖気づいてしまうようなタスクもありますが、簡単にできる作業もたくさんあります。多くの作業は 5 分もかかりません。下記にて、タスクとタスクに対する短い説明とともに、それぞれのタスクのタイプで必要となるおおよその平均時間を確認できます。
選択肢その 1 : 言葉が好き
既存のドキュメントのレビューや編集、またそれらに正しいタグをつけるといった貢献ができます。
- ページの要約作成 (5 - 15 分)
- 編集レビュー (5 – 30 分)
- 既存の記事を新情報に更新 (5 分 - 1 時間)
- 用語集に新規項目を作成 (15 分 - 1 時間)
- 新しいテクノロジーや API の記事を書く (30 分 - 2 時間)
- web の学習を補助する記事を書く (1 - 3 時間)
注記 : 記事をレビューしたり、新しい記事を書く際は、スタイルガイドに目を通しておくようお願いします。その記事の一貫性を保証する助けになります。
選択肢その 2 : コードが好き
さらなるコードサンプルが必要です! あるいはこのサイトのプラットホーム Kuma の構築を手助けできます!
- コードサンプルをライブコードサンプルに変換 (30 分)
- Kuma のビルド環境をセットアップ (1 時間)
- Kuma コードベースにパッチを送る (1 時間)
- 新しいデモを投稿する (1 時間)
選択肢その 3 : 言葉もコードも両方好き
新しい記事の執筆、記事の技術的正確さをレビューする、ドキュメントを調整するといった、技術、言語スキルの双方を要求されるタスクもあります。
- JavaScript ページをタグ付けする (5 分)
- 自分の web サイトで MDN を宣伝する (5 分)
- 技術レビュー (30 分)
- 造形の深い話題について新規記事を執筆する (1 時間以上)
- web の学習を補助するための、インタラクティブな課題を作成する (1 時間以上)
選択肢その 4 : 母国語の MDN が欲しい
MDN 上の全てのローカライゼーションと翻訳作業は、素晴らしいボランティアコミュニティによって行われています。
- ページを翻訳する (2 時間)
- ローカライゼーションプロジェクトに載っているローカライズ担当者と繋がりを持つ (30 分)
選択肢その 5 : 間違った情報を見つけたが修正方法が分からない
文書化のバグを登録する事で、問題を報告できます。 (5 分)
その他の MDN で行える事
- MDN コミュニティに参加する。
- 他の人があなたについて良く知ってもらえるように、プロフィールを記入する。
- MDN への貢献方法について学ぶ。