aboutsummaryrefslogtreecommitdiff
path: root/files/ja/mdn
diff options
context:
space:
mode:
authorMasahiro Fujimoto <mfujimot@gmail.com>2021-03-14 14:43:36 +0900
committerMasahiro Fujimoto <mfujimot@gmail.com>2021-03-14 14:43:36 +0900
commit83b71cf5da4d8503c6b00d0d0b5cac70a419b785 (patch)
tree90f6b63fcb82e71400bc855c52512c4377c11d14 /files/ja/mdn
parent49ead82fc44538406a5fe3d8e3d2417de33c1dab (diff)
downloadtranslated-content-83b71cf5da4d8503c6b00d0d0b5cac70a419b785.tar.gz
translated-content-83b71cf5da4d8503c6b00d0d0b5cac70a419b785.tar.bz2
translated-content-83b71cf5da4d8503c6b00d0d0b5cac70a419b785.zip
Update MDN/Contribute
2021/03/14時点の最新版に更新
Diffstat (limited to 'files/ja/mdn')
-rw-r--r--files/ja/mdn/contribute/index.html104
1 files changed, 100 insertions, 4 deletions
diff --git a/files/ja/mdn/contribute/index.html b/files/ja/mdn/contribute/index.html
index 5d5be87fa3..7b19609761 100644
--- a/files/ja/mdn/contribute/index.html
+++ b/files/ja/mdn/contribute/index.html
@@ -7,12 +7,108 @@ tags:
- MDN Meta
translation_of: MDN/Contribute
---
-<div>{{MDNSidebar}}</div><div>{{IncludeSubnav("/ja/docs/MDN")}}</div>
+<div>{{MDNSidebar}}</div>
-<p>ようこそ!このページを訪れることで、あなたは MDN 貢献者への第一歩を踏み出しました。</p>
+<p>MDN Web Docs はあなたの協力を必要としています。膨大な数の修正すべき記述ミス、書くべき例、修正すべきバグ、相談相手などあり、その数はこのサイトを使い始める人が増えるにつれて増えています。このページでは、皆さんができることをまとめています。</p>
-<p><span class="seoSummary">これらの解説ドキュメントは、MDN への貢献に関するありとあらゆる内容(スタイルガイド / エディタやツールの使い方など)を網羅しています。ページを編集したり作成したりする前に、<a href="https://www.mozilla.org/about/legal/terms/mozilla/">Mozilla の利用規約</a>をよく読んで(そして守って)ください。</span></p>
+<div class="notecard note">
+ <h4>注</h4>
+ <p>初めて MDN に協力する人は、 <a href="/ja/docs/MDN/Contribute/Getting_started">MDN で始めよう</a> のガイドで手順を簡単な 4 つのステップで説明しています。都合がいいことに、あなたはすでにステップ 3 の「協力できるものを探す」の段階にいます。</p>
+</div>
-<p>今まで MDN に貢献したことがない方は、<a href="/ja/docs/MDN/Getting_started">MDN を始めよう</a> のガイドをお読みください。あなたが参加するタスクを選ぶ助けになります。</p>
+<h2 id="What_can_I_do_to_help">協力するためにできること</h2>
+
+<p>MDN に貢献するには、あなたの持つスキルセットや興味に応じて、様々な方法があります。それぞれのタスクには、簡単な説明と、それぞれのタスクにかかるおおよその時間が記載されています。</p>
+
+<p>何をすればよいか分からない人は、いつでも<a href="/ja/docs/MDN/Contribute/Getting_started#step_4_ask_for_help">助けを求めて</a>ください。</p>
+
+<h3 id="Primary_contribution_types">主な貢献の種類</h3>
+
+<p>この節のリンクは、重要な機能であったり、膨大なバックログを抱えていたりして、コミュニティの支援を最も必要としている特定の協力タスクについて、その方法を説明する詳細なガイドにつながっています。他の方法での協力を検討する前に、これらのタスクへの協力をご検討ください。</p>
+
+<table class="standard-table">
+ <thead>
+ <tr>
+ <th scope="col">タスク</th>
+ <th scope="col">解説</th>
+ <th scope="col">必要なスキル</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><a href="/ja/docs/MDN/Contribute/Fixing_MDN_content_bugs">MDN のコンテンツのバグ修正</a></td>
+ <td>MDN の文書で見つかった問題は、<a href="https://github.com/mdn/content/issues">コンテンツリポジトリ</a>に報告されます (古い <a href="https://github.com/mdn/sprints/">sprints リポジトリ</a>にも修正すべきバグがありますが、いずれ閉鎖する予定です)。数多くのコンテンツバグがあるので、それらの修正に協力していただけるととても助かります。</td>
+ <td>
+ <ul>
+ <li>協力する分野のウェブ技術の知識 (JavaScript や CSS など)。</li>
+ <li>英語に関する合理的な理解 (完璧でなくても構いません。私たちが支援します)。</li>
+ </ul>
+ </td>
+ </tr>
+ <tr>
+ <td><a href="https://github.com/mdn/content/blob/main/REVIEWING.md">MDN の編集のレビュー</a></td>
+ <td>MDN のコンテンツを更新するために、<a href="https://github.com/mdn/content/issues">コンテンツリポジトリ</a>にプルリクエストが提出されますので、そのレビューに協力が必要です。 <a href="https://github.com/mdn/content/blob/main/REVIEWING.md">REVIEWING.md</a> ページでは、レビュープロセスの仕組みや、どのようにレビューに参加できるかについて説明しています。</td>
+ <td>
+ <ul>
+ <li>協力する分野のウェブ技術の知識 (JavaScript や CSS など)。</li>
+ <li>英語に関する合理的な理解 (完璧でなくても構いません。私たちが支援します)。</li>
+ </ul>
+ </td>
+ </tr>
+ <tr>
+ <td><a href="/ja/docs/MDN/Contribute/Help_beginners">初心者が MDN で学ぶのに協力する</a></td>
+ <td><a href="/ja/docs/Learn">ウェブ開発を学ぶ</a>ページには、毎月 100 万以上の閲覧があり、一般的なヘルプを求めたり、評価の採点を依頼したりするための<a href="https://discourse.mozilla.org/c/mdn/learn/250">アクティブなフォーラム</a>があります。投稿に解答したり、学習コミュニティを成長させたりする手伝いをしてくださると幸いです。</td>
+ <td>
+ <ul>
+ <li>協力する分野のウェブ技術の知識 (JavaScript や CSS など)。</li>
+ <li>技術的なトピックを説明したり、初心者がコードを学べるようにすることに対する熱意。</li>
+ <li>適度な英語力。完璧である必要はありません。</li>
+ </ul>
+ </td>
+ </tr>
+ </tbody>
+</table>
+
+<p>ここには、時間の経過とともにタスクを追加していきます。</p>
+
+<h4 id="priority_ratings">優先順位</h4>
+
+<p>優先度も見ることで、どの作業が最も重要なのかを知ることができます。コンテンツのバグ問題には、重要度を示すために、P0、P1、P2、P3、P4 というラベルを付け始めました。数字が小さいものは、数字が大きいものより高い優先度です。</p>
+
+<p>これらは、 <a href="/ja/docs/MDN/Contribute/Documentation_priorities">MDN ドキュメントの優先順位リスト</a>に基づいて、通常の MDN バグ・トリアージ・プロセスの中で把握されます。</p>
+
+
+<h3 id="Other_task_types">その他の種類の作業</h3>
+
+<p>上記の優先事項に興味がわかない場合は、スキルセットごとに分けられた、より一般的な種類のタスクを以下に紹介します。</p>
+
+<p id="Option_1_I_like_words">言葉に興味がある方は、以下のことができるでしょう。</p>
+
+<ul>
+ <li><a href="/ja/docs/MDN/Contribute/Howto/Create_and_edit_pages#editing_an_existing_page">既存の記事を新しい情報に更新する</a> (5 分 - 1 時間)</li>
+ <li><a href="/ja/docs/MDN/Contribute/Howto/Write_a_new_entry_in_the_Glossary">用語集に新しい項目を書く</a> (15 分 - 1 時間)</li>
+</ul>
+
+<p>コードのほうが興味がある人は、以下のことに挑戦してみてください。</p>
+
+<ul>
+ <li><a href="/ja/docs/MDN/Contribute/Howto/Convert_code_samples_to_be_live">コードサンプルを「ライブ」に変換</a> (30 分)</li>
+ <li><a href="https://github.com/mdn/yari">Yari のコードベースにコードパッチを送る</a> (1 時間)</li>
+ <li><a href="https://github.com/mdn/interactive-examples/blob/master/CONTRIBUTING.md">インタラクティブな例を書く</a> (1 時間)</li>
+</ul>
+
+<p>言葉とコードの<em>両方</em>に興味があるなら、以下のことに挑戦してみてください。</p>
+
+<ul>
+ <li><a href="/ja/docs/MDN/Contribute/Howto/Write_an_API_reference">API リファレンスを書いたり更新したりする</a> (30 分から 2 時間以上)</li>
+ <li><a href="https://github.com/mdn/content#adding-a-new-document">なじみのある分野のトピックで新しい記事を書く</a> (1 時間以上)</li>
+ <li><a href="/ja/docs/MDN/Structures/Compatibility_tables">リファレンスページのブラウザー互換性データを追加したり更新したりする</a> (30 分から 1 時間)</li>
+</ul>
+
+<div class="notecard note">
+<p><strong>注</strong>: MDN 上で誤りを見つけたものの、それを修正する方法が分からない場合、<a href="https://github.com/mdn/content/issues/new">ドキュメントの問題を提出</a>することで問題を報告することができます。その際、問題を説明するタイトルを付けてください。(どこでリンクを見つけたかを書かずに「リンク切れ」と言っても役に立ちません。)</p>
+</div>
+
+<h2 id="Other_useful_pages">その他の有用なページ</h2>
<p>{{LandingPageListSubPages()}}</p>