Merge pull request #131 from mfuji09/MDN-Contribute-Getting_started

MDN/Contribute/Getting_started を更新

1 files changed, 22 insertions, 68 deletions

diff --git a/files/ja/mdn/contribute/getting_started/index.html b/files/ja/mdn/contribute/getting_started/index.html
index 0d0cde409c..b1423a5614 100644
--- a/files/ja/mdn/contribute/getting_started/index.html
+++ b/files/ja/mdn/contribute/getting_started/index.html
@@ -17,92 +17,46 @@ translation_of: MDN/Contribute/Getting_started
 
 <p id="What_is_MDN.3F"><span class="seoSummary">私たちは開発者のオープンなコミュニティであり、ブランドやブラウザー、プラットフォームを問わず、ウェブをより良くするリソースを構築しています。誰でも協力でき、それによってコミュニティはより強固なものとなります。ともに協力することで、ウェブをより良いものへ革新していく後押しを継続できます。ここから、あなたと始まります。</span></p>
 
-<p><span>MDN のすべての部分 (文書、デモ、そしてこのサイト自体) は、開発者のオープンなコミュニティによって作成されています。ぜひ参加してください。</span></p>
+<p>MDN のすべての部分 (文書、デモ、そしてこのサイト自体) は、開発者のオープンなコミュニティによって作成されています。ぜひ参加してください。</p>
 
-<h2 id="3_simple_steps_to_MDN" name="3_simple_steps_to_MDN">MDN への簡単な 3 ステップ</h2>
+<h2 id="4_simple_steps_to_MDN">MDN への簡単な 4 ステップ</h2>
 
-<p>MDN は Wiki であり、<strong>誰でも</strong>コンテンツを追加、編集することができます。プログラマーであったり、技術に精通していたりする必要はありません。簡単なこと (校正や誤字の修正) から、複雑なこと (API ドキュメントの執筆) まで、行うべき事はたくさんあります。</p>
+<p>MDN はオープンソースのリソースであり、<strong>誰でも</strong>コンテンツを追加したり編集したりすることができます。プログラマーであったり、技術に精通していたりする必要はありません。簡単なこと (校正や誤字の修正) から、複雑なこと (API ドキュメントの執筆) まで、行うべきことはたくさんあります。</p>
 
-<p>協力するのは簡単で危険を伴いません。間違ってしまった場合でも、簡単に修正できます。出来栄えをどうすべきかわからなかったり、文法が完璧でなかったりしても、気にしないで！ MDN にあるコンテンツをできるだけ良くすることを専門とするチームがあります。誰かがやってきて、あなたの成果がきちんと丁寧に書かれているかどうか確認してくれます。あなたの知識を共有し、長所を活かしましょう。</p>
+<p>協力することは簡単で危険を伴いません。間違ってしまった場合でも、簡単に修正できます。出来栄えをどうすべきかわからなかったり、文法が完璧でなかったりしても、気にしないでください。 MDN にあるコンテンツをできるだけ良くすることを専門とするチームがあります。誰かがやってきて、あなたの成果がきちんと丁寧に書かれているかどうか確認してくれます。あなたの知識を共有し、長所を活かしましょう。</p>
 
-<h3 id="Step_1_Create_an_account_on_MDN" name="Step_1_Create_an_account_on_MDN">ステップ 1 : MDN のアカウントを作成する</h3>
+<h3>ステップ 1: GitHub アカウントを作成する</h3>
 
-<p>MDN への協力を開始するには、 MDN のアカウントが必要です。詳細は「<a href="/ja/docs/MDN/Contribute/Howto/Create_an_MDN_account">MDN アカウントを作成するには</a>」をご覧ください。</p>
+<p>MDN への協力を始めるには、 <a href="https://github.com/mdn/content/#setup">GitHub アカウント</a> を作成する必要があります。</p>
 
-<h3 id="Step_2_Pick_a_task_to_complete" name="Step_2_Pick_a_task_to_complete">ステップ 2 : 完成させるタスクを選ぶ</h3>
 
-<p>ログインしたら、{{anch("Possible task types", "下記リスト")}}内の、色々なタスクの種類についての説明を読んで、最もやってみたいものを決めましょう。お好きなタスクを選択し、協力を開始することができます。</p>
+<h3 id="Step_2_Pick_a_task_to_complete">ステップ 2: 完成させるタスクを選ぶ</h3>
 
-<h3 id="Step_3_Do_the_task" name="Step_3_Do_the_task">ステップ 3 : タスクを行う</h3>
+<p>ログインしたら、<a href="/ja/docs/MDN/Contribute">貢献ページ</a>内にある色々なタスクの種類についての説明を読んで、最もやってみたいものを決めましょう。好きなタスクを選択して、協力を始めましょう。</p>
 
-<p>やってみたいタスクを決めて、作業対象とする特定のページや、コード例などを探したら、あとはただやってみましょう！</p>
+<h3 id="Step_3_Do_the_task">ステップ 3: タスクを実行する</h3>
 
-<p>完璧にしようと悩まないで。 MDN に協力している他の方々が、見落とした間違いの修正を手伝ってくれます。何かを「実際に」行う前に試してみたいのであれば、 <a href="/ja/docs/Sandbox">Sandbox</a> ページで試してみることができます。進めていくにつれ疑問がわいたら、回答が得られるメーリングリストやチャットチャンネルについての情報が載っている<a href="/ja/docs/MDN/Community">コミュニティに関するページ</a>をご覧ください。</p>
+<p>やってみたいタスクが決まったら、作業対象とするページや、コード例などを見つけ、あとはただやってみましょう。</p>
 
-<p>終了したら、自由に他の項目を選ぶか、あるいは下記にある<a href="#Other_things_you_can_do_on_MDN">その他の MDN で行えること</a>をご覧ください。</p>
+<h3 id="Step_4_Ask_for_help">ステップ 4: 助けを求める</h3>
 
-<h2 id="Possible_task_types" name="Possible_task_types">協力できるタスクの種類</h2>
-
-<p>MDN に協力するための道は、スキルや興味によって複数のものがあります。中には怖気づいてしまうようなタスクもありますが、簡単にできる作業もたくさんあります。多くの作業は 5 分もかかりません。タスクとタスクに対する短い説明とともに、それぞれのタスクのタイプで必要となるおおよその平均時間を確認できます。</p>
-
-<h3 id="Option_1_I_like_words" name="Option_1_I_like_words">その1: 言葉が好き</h3>
-
-<p>既存のドキュメントのレビューや編集、またそれらに正しいタグをつけるといった協力ができます。</p>
-
-<ul>
- <li><a href="/ja/docs/MDN/Contribute/Howto/Set_the_summary_for_a_page">ページの要約作成</a> (5-15分)</li>
- <li><a href="/ja/docs/MDN/Contribute/Howto/Do_an_editorial_review">編集レビュー</a> (5-30分)</li>
- <li><a href="/ja/docs/MDN/User_guide/Writing#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>
- <li><a href="/ja/docs/MDN/Contribute/Howto/Create_and_edit_pages">新しい技術や API についての記事を書く</a> (30分-2時間)</li>
- <li><a href="/ja/docs/MDN/Contribute/Howto/Write_an_article_to_help_learn_about_the_Web">ウェブの学習を補助する記事を書く</a> (1-3時間)</li>
-</ul>
-
-<div class="note"><strong>メモ:</strong> 記事をレビューしたり、新しい記事を書いたりする際は、<a href="/en-US/docs/MDN/Contribute/Guidelines/Writing_style_guide">スタイルガイド</a>に目を通しておくようお願いします。その記事の一貫性を保証する助けになります。</div>
-
-<h3 id="Option_2_I_like_code" name="Option_2_I_like_code">その2: コードが好き</h3>
-
-<p>さらなるコード例が必要です！あるいはこのサイトのプラットホームである <a href="/ja/docs/MDN/Kuma">Kuma</a> の構築を手伝っていただくこともできます！</p>
-
-<ul>
- <li><a href="/ja/docs/MDN/Contribute/Howto/Convert_code_samples_to_be_live">コード例を作成する</a> (30分)</li>
- <li><a href="https://kuma.readthedocs.io/en/latest/installation.html">Kuma のビルド環境をセットアップ</a> (1時間)</li>
- <li><a href="https://github.com/mozilla/kuma/blob/master/CONTRIBUTING.md">Kuma コードベースにパッチを送る</a> (1時間)</li>
- <li><a href="/ja/docs/Web/Demos_of_open_web_technologies">新しいデモを投稿 </a>(1時間)</li>
-</ul>
-
-<h3 id="Option_3_I_like_both_words_and_code" name="Option_3_I_like_both_words_and_code">その3: 言葉もコードも両方好き</h3>
-
-<p>新しい記事の執筆、技術的正確さのレビュー、文書の調整など、技術と言語の両方のスキルを必要とするタスクもあります。</p>
-
-<ul>
- <li><a href="/ja/docs/MDN/Contribute/Howto/Tag_JavaScript_pages">JavaScript ページのタグ付けする</a> (5分)</li>
- <li><a href="/ja/docs/MDN/About/Promote">自分のウェブサイトで MDN を宣伝</a> (5分)</li>
- <li><a href="/ja/docs/MDN/Contribute/Howto/Do_a_technical_review">技術レビュー</a> (30分)</li>
- <li><a href="/ja/docs/MDN/Contribute/Structures/API_references">API リファレンスの執筆または更新</a> (30分から2時間以上)</li>
- <li><a href="/ja/docs/MDN/Contribute/Howto/Create_and_edit_pages#Creating_a_new_page">よく知っている主題の新しい記事を執筆する</a> (1時間以上)</li>
- <li><a href="/ja/docs/MDN/Contribute/Structures/Compatibility_tables">リファレンスページのブラウザー互換性データを追加または更新</a> (30分から1時間)</li>
-</ul>
-
-<h3 id="Option_4_I_want_MDN_in_my_language" name="Option_4_I_want_MDN_in_my_language">その4: 母国語の MDN が欲しい</h3>
-
-<p>MDN 上の全てのローカライゼーションと翻訳の作業は、素晴らしいボランティアコミュニティによって行われています。</p>
+<p>どんな時点でも、何をすればよいかわからない場合は、ぜひ助けを求めてください。助けを求めるにはいくつかの方法があります。</p>
 
 <ul>
- <li><a href="/ja/docs/MDN/Contribute/Localize/Translating_pages">ページを翻訳する</a> (2時間)</li>
- <li><a href="/ja/docs/MDN/Contribute/Localize/Localization_projects">ローカライゼーションプロジェクト</a>に載っているローカライズ担当者と繋がりを持つ (30分)</li>
+ <li>リアルタイムで話したい、 MDN 自体について質問したいという方は、 <a href="https://wiki.mozilla.org/Matrix">Matrix</a> の <a href="https://chat.mozilla.org/#/room/#mdn:mozilla.org">MDN Web Docs チャットルーム</a>で議論に参加してください。</li>
+ <li>また、 <a href="mailto:mdn-admins@mozilla.org">mdn-admins@mozilla.org</a> にメールを送っていただくこともできます。</li>
+ <li>もしあなたがウェブ開発を学んでいて、コーディングの問題で行き詰まっているのであれば、質問したり助けを得たりすることができる<a href="https://discourse.mozilla.org/c/mdn/learn/250">アクティブなフォーラム</a>があります。</li>
 </ul>
 
-<h3 id="Option_5_I_found_some_wrong_info_but_I_dont_know_how_to_fix_it" name="Option_5_I_found_some_wrong_info_but_I_dont_know_how_to_fix_it">その5: 間違った情報を見つけたが修正方法が分からない</h3>
-
-<p>問題は<a class="external" href="https://bugzilla.mozilla.org/enter_bug.cgi?product=Mozilla%20Developer%20Network">文書のバグをファイル</a>することで報告することができます。 (5分)</p>
+<p>完璧にしようと悩まないで。 MDN に協力している他の方々が、見落とした間違いの修正を手伝ってくれます。</p>
 
-<p>問題には説明的な題名をつけてください。 (どこでリンクを見つけたかを書かずに「リンク切れ」と書くのは役に立ちません。プロのヒント: MDN の「リンク切れ」の多くは、まだ書かれていない記事へのリンクです)。 "Request type" の下のところは、問題を発見した場合は "Correction or update"、 MDN から何かが欠けている場合は "New documentation" の括弧の中に "x" を入れてください。 "Details" の下には、問題について、およびどこで正しい情報が見つかるか、知っている限り、時間が許す限り多くの情報を書いてください。これには、ウェブリンクだけでなく、人 ("誰と誰に聞く") を含めることができます。</p>
+<h2 id="useful_complete_beginners_guides">完全な初心者向けの便利なガイド</h2>
 
-<h2 id="Other_things_you_can_do_on_MDN" name="Other_things_you_can_do_on_MDN">その他の MDN でできること</h2>
+<p>MDN への協力者は、コンテンツの作業を始める前に、ある程度の前提知識を持っていることが期待されます。以下のトピックが初めての方は、スピードアップできるようにリンク先を読むことをお勧めします。</p>
 
 <ul>
- <li><a href="/ja/docs/MDN/Community">MDN コミュニティに参加</a>する。</li>
- <li>他の人があなたについて良く知ってもらえるように、<a href="/ja/profile">プロフィールを記入</a>する。</li>
- <li><a href="/ja/docs/MDN/Contribute">MDN への協力方法</a>について学ぶ。</li>
+  <li>ウェブ技術。 HTML, CSS, JavaScript などの初心者ならば、<a href="/ja/docs/Learn">ウェブ開発を学ぶ</a>のチュートリアルをご覧ください。</li>
+  <li>オープンソース。もし今までオープンソースプロジェクトに貢献したことがないのであれば、<a href="/ja/docs/MDN/Contribute/Open_source_etiquette">オープンソースプロジェクトの基本的なエチケット</a>をお読みください。</li>
+  <li>Git と GitHub。もしこれらのツールに慣れていないのであれば、<a href="/ja/docs/MDN/Contribute/GitHub_beginners">完全な初心者向けの GitHub</a> を読むといいでしょう。</li>
+  <li>MDN のリポジトリ構造。 MDN のコンテンツの様々な部分に変更を加えるために、どのリポジトリを編集すればよいか分からない場合は、 <a href="/ja/docs/MDN/Contribute/Where_is_everything">MDN 上のものはどこにあるのか</a>が正しい場所を教えてくれます。</li>
 </ul>