diff options
Diffstat (limited to 'files/ja/mdn/contribute')
-rw-r--r-- | files/ja/mdn/contribute/github_best_practices/index.html | 48 | ||||
-rw-r--r-- | files/ja/mdn/contribute/github_cheatsheet/index.html | 77 |
2 files changed, 125 insertions, 0 deletions
diff --git a/files/ja/mdn/contribute/github_best_practices/index.html b/files/ja/mdn/contribute/github_best_practices/index.html new file mode 100644 index 0000000000..df71260add --- /dev/null +++ b/files/ja/mdn/contribute/github_best_practices/index.html @@ -0,0 +1,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> diff --git a/files/ja/mdn/contribute/github_cheatsheet/index.html b/files/ja/mdn/contribute/github_cheatsheet/index.html new file mode 100644 index 0000000000..2842d4ddbc --- /dev/null +++ b/files/ja/mdn/contribute/github_cheatsheet/index.html @@ -0,0 +1,77 @@ +--- +title: GitHub 早見表 +slug: MDN/Contribute/GitHub_cheatsheet +tags: + - Best practices + - Community + - GitHub + - MDN + - Beginners + - Cheatsheet + - Commands +--- +<p>{{MDNSidebar}}</p> + +<p>この記事では、 MDN に協力するために <a href="https://git-scm.com/">Git</a> と <a href="https://github.com/">GitHub</a> を使用する際に必要となる基本的なコマンドのクイックリファレンスを提供します。これらのツールに慣れておらず、助けが必要な場合は、<a href="/ja/docs/MDN/Contribute/GitHub_beginners">全くの初心者のための GitHub</a> チュートリアルで基本的なことを教えています。</p> + +<h2 id="Cloning">クローン</h2> + +<pre class="brush: bash">git clone <em>the-repo-url</em></pre> + +<h2 id="setting_up_a_remote">リモートをセットアップ</h2> + +<pre class="brush: bash">git remote add <em>remote-name</em> <em>repo-you-want-to-point-to</em></pre> + +<h2 id="view_remotes_list">リモートの一覧を表示</h2> + +<pre class="brush: bash">git remote -v</pre> + +<h2 id="preparing_to_make_a_change_to_the_repo">リポジトリに変更を加える準備</h2> + +<h3 id="switch_to_the_main_branch">メインブランチに切り替え</h3> + +<pre class="brush: bash">git switch main</pre> + +<h3 id="update_your_main_branch">メインブランチを更新</h3> + +<pre class="brush: bash">git fetch <em>remote-name</em> +git rebase <em>remote-name</em>/main +git push</pre> + +<h2 id="get_your_branch_locally_and_switch_to_it">ブランチをローカルに取得して切り替える</h2> + +<pre class="brush: bash">git pull +git switch new-branch</pre> + +<h2 id="get_latest_status">最新のステータスを取得</h2> + +<pre class="brush: bash">git status</pre> + +<h2 id="adding_committing_and_pushing_changes">追加、コミット、変更をプッシュ</h2> + +<pre class="brush: bash">git add path-to-changed-file +git commit -m 'my commit message' +git push</pre> + +<h2 id="troubleshooting">トラブルシューティング</h2> + +<h3 id="reverting_a_change_you_made_to_a_file_that_you_havent_yet_added_to_the_commit_list">コミットリストに追加されていないファイルに加えた変更を元に戻す</h3> + +<pre class="brush: bash">git restore <em>file-path</em></pre> + +<h3 id="removing_a_file_from_the_commit_list">コミットリストからファイルを削除</h3> + +<pre class="brush: bash">git restore --staged <em>file-path</em></pre> + +<h3 id="reversing_a_commit">最後のコミットを取り消す</h3> + +<pre class="brush: bash">git reset HEAD~1</pre> + +<h3 id="reversing_a_commit_that_has_been_pushed_to_the_remote_fork">リモートフォークにプッシュされたコミットを元に戻す</h3> + +<pre class="brush: bash">git revert HEAD +git push</pre> + +<h2 id="want_to_see_more">もっと見たいですか?</h2> + +<p>この早見表にもっと多くのコマンドを載せるべきだと思われる場合は、 <a href="https://github.com/mdn/content/issues/new">issue を作成</a>して提案してください。</p> |