files/ja/mdn/contribute/github_best_practices/index.html


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48

---
title: MDN のための GitHub のベストプラクティス
slug: MDN/Contribute/GitHub_best_practices
tags:
  - Best practices
  - Community
  - GitHub
  - MDN
---
<p>{{MDNSidebar}}</p>

<p>このページでは、 MDN に協力するために GitHub を使用する際のベストプラクティスを、主に課題 (issues) の扱い方を中心にご紹介します。</p>

<h2 id="when_choosing_a_github_issue_to_work_on">作業する GitHub の課題を選ぶとき</h2>

<ol>
 <li>担当したいという旨のコメントをその課題の中に書いていただければ、その課題を割り当てます。
  <ul>
   <li>誰か他の人が課題に割り当てられていた場合は、次のようにしてください。
    <ol>
     <li>1 週間以上前からあまり動きがない場合は、 @ メンションして、引き継ぐことができるかどうか、あるいは完了するまで手伝うかどうかを聞いてみてください。
      <ul>
       <li>引き継ぐことにその人が同意した場合は、あなたをその問題に割り当て、その人を削除します。</li>
       <li>引き継ぐことにその人が同意し、すでに何らかの作業が行われている場合や、その人が作業を手伝うことに合意した場合は、あなたも共同担当にします。</li>
      </ul>
     </li>
     <li>もし 1 週間経っていないのであれば、少し我慢して、その人に作業のチャンスをあげてください。</li>
    </ol>
   </li>
  </ul>
 </li>
 <li>もし、課題が完了したがレビューが必要とマークされていて、あなたがレビューしたい場合は、コメントでその人に @ メンションして、レビューしたいと伝えてください。</li>
</ol>

<h2 id="when_youve_been_assigned_to_an_issue">課題を割り当てられたとき</h2>

<ol>
 <li>行う必要がある残りの作業を検討してください。
  <ul>
   <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>
  </ul>
 </li>
 <li>問題が解決したと思ったら、コメントでレビューを依頼しましょう。</li>
 <li>課題のレビューが完了し、コメントが回答されれば、その課題を閉じる (closed にする) ことができます。</li>
 <li>もし、課題に取り組む時間がなくなった場合は、コメントで知らせていただければ、他の人に割り当てます。</li>
</ol>