Merge pull request #181 from mfuji09/Help_beginners

MDN/Contribute/Help_beginners を新規翻訳

1 files changed, 111 insertions, 0 deletions

diff --git a/files/ja/mdn/contribute/help_beginners/index.html b/files/ja/mdn/contribute/help_beginners/index.html
new file mode 100644
index 0000000000..03d848fcff
--- /dev/null
+++ b/files/ja/mdn/contribute/help_beginners/index.html
@@ -0,0 +1,111 @@
+---
+title: 初心者が MDN で学習するのを支援しましょう
+slug: MDN/Contribute/Help_beginners
+tags:
+  - Beginner
+  - Contribute
+  - HELP
+  - Learning
+  - MDN
+---
+<p>{{MDNSidebar}}</p>
+
+<p><a href="/ja/docs/Learn">ウェブ開発を学ぶ</a>のページ群は、毎月 100 万回以上の閲覧があり、一般的な助けを求めたり、評価の採点を依頼したりするための<a href="https://discourse.mozilla.org/c/mdn/learn/250">アクティブなフォーラム</a>があります。投稿に回答したり、学習コミュニティを成長させたりする手伝いをしてくださると幸いです。</p>
+
+<h2 id="What_do_we_need_help_with">どのような支援が必要か</h2>
+
+<p><a href="https://discourse.mozilla.org/c/mdn/learn/250">MDN 学習フォーラム</a>では、主に二つの種類の投稿があり、その回答にご協力をお願いしています。</p>
+
+<ol>
+ <li>ウェブ開発に関する一般的な質問。</li>
+ <li>MDN の「ウェブ開発を学ぶ」の章に掲載されているスキルテストや評価についてのヘルプや評価を求める特定の質問。</li>
+</ol>
+
+<h2 id="How_can_you_benefit">どのような利益があるか</h2>
+
+<ul>
+ <li>コードの問題で人々を助けることは、ウェブ技術をより深く学ぶための素晴らしい方法です。解決策を研究し、誰かの質問に対する答えを書くことで、そのテーマをより深く理解し、自分のスキルを向上させることができます。</li>
+ <li>MDN コミュニティに参加していくにつれ、 Mozilla のスタッフや他のコミュニティメンバーと知り合うことができ、自分の問題を手伝ってもらったり、自分の知名度を上げたりするための貴重なネットワークとなります。</li>
+ <li>コーディングの質問に答える手伝いをすることは、それだけで大きなものが得られますが、ウェブ技術に関するあなたの専門知識を証明することにもなり、場合によっては進路や仕事の機会にもなるでしょう。</li>
+</ul>
+
+<h2 id="What_skills_do_you_need">どのようなスキルが必要か</h2>
+
+<ul>
+ <li>HTML、CSS、JavaScript などのウェブ技術に精通している必要があります。また、技術的なトピックを説明するのが得意で、初心者がコードを学ぶのを手助けすることを楽しめる人が理想的です。</li>
+ <li>フォーラムの言語は英語です。それなりの英語力が必要ですが、完璧である必要はありません。フォーラムには世界中から人が集まってきます。私たちは、フォーラムを訪れるすべての人に、できる限り快適に、そして仲間に入れてもらいたいと思っています。</li>
+</ul>
+
+<h2 id="How_to_help">支援する方法</h2>
+
+<ol>
+ <li>まず最初に、まだお持ちでなければ、 <a href="/ja/docs/MDN/Contribute/Getting_started#step_1_create_an_account_on_mdn">MDN アカウントをサインアップしてください</a>。学習分野での支援に絶対に必要というわけではありませんが、長い目で見れば役に立ちます。</li>
+ <li>また、まだであれば <a href="https://discourse.mozilla.org/">Mozilla Discourse</a>  にも登録してください。</li>
+ <li>もしまだであれば、<a href="/ja/docs/Learn">ウェブ開発を学ぶ</a>の章を見て、そこにあるものについて基本的なレベルの知識を得てください (下記の {{anch("Structure of the MDN Learning Area")}} の節を参考にしてください)。</li>
+</ol>
+
+<h3 id="Once_you_are_set_up">設定が終わったら</h3>
+
+<ol>
+ <li><a href="https://discourse.mozilla.org/c/mdn/learn/250">学習フォーラム</a>を見て、返信のない投稿があるかどうかを確認してください。ここが始めるにあたって最適な場所です。
+
+  <ul>
+   <li>ヒント: 返信のないものが見つからない場合は、最近更新があった他のフォーラムをチェックして、まだ言われていない有益なことを追加できるかどうかを確認してください。</li>
+  </ul>
+ </li>
+ <li>もし返信している投稿が一般的な助けを求めるものであれば、彼らに返信し、時間が許す限り助けてあげてください。</li>
+ <li>返信している投稿が "test your skill"/"assessment" タスクの1つに対して評価をリクエストしているものである場合は、以下のようにします。
+  <ol>
+   <li>どの記事/タスクが評価されているかを確認し、関連する採点ガイドを見つけてください。評価/スキルテストへのリンクを教えてくれるよう、投稿した人に尋ねてもまったく問題ありません。</li>
+   <li>その人のコードを特定してください。 — codepen/jsfiddle/jsbin のリンク、または同様の形式で提供してもらえるはずです。もし、その人が評価しやすい形でコードを提供してくれない場合は、 codepen や jsfiddle などに入れてくれるように頼んでも全く問題ありません。
+    <ul>
+     <li>よくある問題は、 discourse のメッセージに直接コードを投稿してしまうことです。 — discourse は HTML 要素をレンダリングし、引用符を smartquote に変えてしまうので、コードを壊してしまいます。それよりも、共有可能なコードエディターアプリへの URL として送ってもらう方がはるかに良いでしょう。</li>
+    </ul>
+   </li>
+   <li>コードを一通り読み、評価しましょう。
+    <ol>
+     <li>コードは動作していますか？また、得られるべき結果は得られていますか？</li>
+     <li>うまくいかない場合は、なぜうまくいかないのですか？</li>
+     <li>コードをより良くするためのヒント (より効率的な方法、ベストプラクティスなど) はありますか？</li>
+    </ol>
+   </li>
+   <li>彼らがやった方法について報告してあげましょう。
+    <ol>
+     <li>採点ガイドの中には、問題の各部分に点数をつけた採点方法を提案しているものもありますが、そこまで正確にする必要はありません。</li>
+     <li>いくつかの点を除いて素晴らしい出来だった場合は、その点を伝えつつ、たくさん褒めてあげましょう。</li>
+     <li>その人がもう少しで完成するところまで行ったが、完全にはうまくいかなかった場合、その人はよくやったと言いつつ、うまくいくために必要な修正点を伝え、私たちがやったことが見られるように採点ガイドへのリンクを貼るのもいいでしょう。</li>
+     <li>もし、その人が解決策を見つけられなかった場合は、親切に励まし、どのような方向に進むべきか、いくつかのヒントを与えてあげてください。もっとうまくできるように、もう一度チャンスを与えてあげてください。</li>
+     <li>もし何か助けが必要な場合は、 <a href="https://wiki.mozilla.org/Matrix">Matrix</a> の <a href="https://chat.mozilla.org/#/room/#mdn:mozilla.org">MDN Web Docsチャットルーム</a>で助けを求めてください。</li>
+    </ol>
+   </li>
+  </ol>
+ </li>
+</ol>
+
+<div class="notecard warning">
+<p>重要: 何よりも、忍耐強く、友好的で、親切であること。忘れないでください — これらの人々のほとんどは初心者です。</p>
+</div>
+
+<h2 id="Structure_of_the_MDN_Learning_Area">MDN 学習エリアの構成</h2>
+
+<p>MDN の<a href="/ja/docs/Learn">ウェブ開発を学ぶ</a>の章に関連する質問の回答を手伝う際には、その周辺を見て、そこにあるものについて基本的なレベルの知識を得ることをお勧めします。</p>
+
+<ol>
+ <li>一般的なページ構造に目を通してください。</li>
+ <li>特に、利用可能な評価の種類に注目してください。
+  <ul>
+   <li>数多くの「うでだめし」記事が用意されています (例えば <a href="/ja/docs/Learn/JavaScript/Building_blocks/conditionals#test_your_skills!">/ja/docs/Learn/JavaScript/Building_blocks/conditionals#Test_your_skills!</a> を参照してください)。</li>
+   <li>モジュールによっては、最後にもっと詳しい評価テストがあります (例えば <a href="/ja/docs/Learn/JavaScript/Building_blocks/Image_gallery">/ja/docs/Learn/JavaScript/Building_blocks/Image_gallery</a> を参照してください)。</li>
+  </ul>
+ </li>
+ <li>学習エリアに関連する GitHub リポジトリを見てみましょう (ほとんどのファイルは <a href="https://github.com/mdn/learning-area/">https://github.com/mdn/learning-area/</a> に、一部は <a href="https://github.com/mdn/css-examples/tree/master/learn">https://github.com/mdn/css-examples/tree/master/learn</a> で利用できます)。学習者が助けを求めている例のほとんどがここに含まれています。</li>
+ <li>それぞれの評価やスキルテストには、学習者の作業を評価するのに役立つように、関連する採点ガイドと模範解答が用意されています。</li>
+ <li>これらのリソースを見つけやすくするために、例えば以下のようなパターンがあります。
+  <ul>
+   <li>上記の「うでだめし」の採点ガイドとリソースは、 <a href="https://github.com/mdn/learning-area/tree/master/javascript/building-blocks/tasks/conditionals">https://github.com/mdn/learning-area/tree/master/javascript/building-blocks/tasks/conditionals</a> にあります。</li>
+   <li>上記の評価テストの採点ガイドとリソースは、 <a href="https://github.com/mdn/learning-area/tree/master/javascript/building-blocks/gallery">https://github.com/mdn/learning-area/tree/master/javascript/building-blocks/gallery</a> にあります。</li>
+  </ul>
+ </li>
+</ol>
+
+<p>最初のうちは、これらの資料をすべて見て回るのは難しいと思われるかもしれませんが、演習に慣れてくると、次第に簡単になってくるでしょう。</p>