MDN コンテンツのバグ修正

MDN Web Docs に関する問題は、コンテンツリポジトリーの課題 (issue) として報告されます。この記事では、あなたの専門知識と作業可能な時間に基づいて、作業するのに最適な問題を見つけ、それらを修正するための主な手順を概説します。

メモ: コンテンツのバグはたくさんあります。修正するためにご協力いただけるのであれば、何でも助かります。

メモ: 訳注: この記事は原文 (英語) の記事の修正に関する案内です。そのため、下記のリンクは英語版の文書に対するリンクになっています。日本語訳の課題については translated-content リポジトリー上の l10n-ja の課題mozilla-japan/translation リポジトリー上の課題を参照してください。

協力が必要なこと

コンテンツのどの課題に取り組むべきかを選択するのに役立つよう、 GitHub のラベルを使って分類しました。

以下のラベルは、どれだけ時間があるかによってタスクを探すのに役立ちます。

ラベル 説明
content リポジトリー上の 30 分未満のタスク おそらく 30 分以内のタスクです。
content リポジトリー上の 3 時間未満のタスク おそらく 3 時間以内のタスクです。
content リポジトリー上の 2 日未満のタスク おそらく 2 日以内のタスクです。

代わりに技術カテゴリーでタスクを閲覧して選びたい場合は、issue in content repositoryでコンテンツタイプのラベルも見つけることができます。

どんなメリットがあるのか

  • MDN のコンテンツのバグを修正することは、ウェブ技術をより深く学ぶための素晴らしい方法です。問題を調査し、必要なコンテンツを作成することで、そのテーマに対する理解が深まり、自分のスキルが向上します。
  • また、 MDN コミュニティに参加することで、 Mozilla のスタッフや他のコミュニティメンバーと知り合うことができ、自分が抱えている問題を助けてもらったり、自分の知名度を高めたりするための貴重なネットワークとなります。
  • 問題の解決に協力することは、それだけで大きな報酬になりますが、オープンソースへの貢献の記録にもなり、自分のウェブ技術に関する専門知識を証明することになり、場合によっては進路や就職の際にも役立つでしょう。

必要なスキルは何か

  • 手伝っていただくことにしたトピック領域(JavaScript、CSS など)についての知識が必要です。
  • 手伝っていただく例やページのほとんどは英語で書かれていますので、英語を適度に理解している必要があります。しかし、英語が完璧でなくても心配しないでください。私たちのチームは、どのように書いてもきれいに仕上げることが大好きです。

手伝う方法

  1. 最初に、 GitHub アカウントをまだお持ちでなければサインアップしてください。 GitHub の課題でやり取りするのに必要です。
  2. 次に、手伝いたいトピック領域を 1 つ以上選んでください。上記の一覧を使用して、より詳しい情報を得ると選択をするのに役立ちます。何を選べばよいのか分からない場合は、 MatrixMDN Web Docs チャットルームで聞いてみましょう。

セットアップが完了したら、次のようにします。

  1. 興味のある課題を選んで、その課題に対するコメントを添えて、自分に割り当ててもらいましょう。
  2. 作業中に分からないことがあったら、 MatrixMDN Web Docs チャットルームで気軽に相談してください。
  3. 問題を修正したら、提出者にレビューを依頼してください。うまくいけば、さらに作業が必要だと思うかどうかを教えてくれるでしょう。必要に応じて私たちも関与します。
  4. 課題が修正されたことが確認されたら、閉じることができます。課題を閉じることができる人は、元の課題の提出者か、 MDN のスタッフのどちらかです。