[![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # First Contributions 初めてのことは何でも大変なものです。特に他人と協力する時に、間違うのは気持ちの良いことではありません。しかし、オープンソースにおける活動では協力することが全てです。私たちは初めてオープンソースへの貢献を始める人たちが簡単に貢献する方法を学べるようにしたいと考えています。 記事を読んだりチュートリアルをやってみることはためになりますが、実際にやってみる方が良いでしょう。このプロジェクトはそのガイダンスを行い、初心者が最初のオープンソースへの貢献を簡単に行えるようにするためのものです。
**覚えておいてください**: リラックスしているほどより良く学ぶことができます。初めてのオープンソースへの貢献を行いたいのなら以下の簡単なステップに従ってください。それはとても面白いものになるでしょう。 #### *コマンドラインでの操作に慣れていない場合、[グラフィカルなツールでもチュートリアルを行えます。]( #その他のツールを使用したチュートリアル )* fork this repository まだGitをインストールしていない場合は、[ここ](https://help.github.com/articles/set-up-git/)からインストールしてください ## リポジトリをフォーク Forkボタンをクリックしてこのリポジトリをフォークしてください。 この作業はあなたのアカウントにこのリポジトリのコピーを作ります。 ## リポジトリをクローン clone this repository 次にレポジトリをクローンします。*Clone and download*ボタンをクリックした後に*Copy to clipboard*アイコンをクリックしてください。 ターミナルを開いて以下のgitコマンドを実行してください: ``` git clone "コピーしたURL" ``` "コピーしたURL" (ダブルクオーテーションは除いてください) は先ほどコピーしたリポジトリのURLと置き換えてください。 copy URL to clipboard 例: ``` git clone https://github.com/<あなたのユーザー名>/first-contributions.git ``` `あなたのユーザー名` はご自身のGitHubユーザー名に置き換えてください。この作業でGitHub のリポジトリの内容はあなたのコンピュータに保存されました。 ## ブランチを作成 もしリポジトリのディレクトリにいなければそこまで移動してください。 ``` cd first-contributions ``` `git switch` コマンドを使用してブランチを作成します: ``` git switch -c ``` 例: ``` git switch -c add-alonzo-church ``` (ブランチの名前には必ずしも*add*が含まれていなければならないわけではありませんが、このブランチの目的があなたの名前をリストに加えることであることを考慮すれば含むのが適切です。) ## コードを変更してその変更をコミット テキストエディタで`Contributors.md`ファイルを開いてあなたの名前を追加してください。ただし、ファイルの先頭または最後に追加しないようにしましょう。名前リストの間のどこか好きな場所に、あなたの名前を追加するようにしてください。あなたの名前をファイルに加えたら、ファイルを保存します。 git status プロジェクトディレクトリに移動して`git status`を実行すると、変更がなされたことが確認できると思います。`git add`コマンドを使ってそれらの変更を適用してください。 ``` git add Contributors.md ``` 次に`git commit`コマンドを使ってこれらの変更をコミットします。 ``` git commit -m "Add <あなたの名前> to Contributors list" ``` `<あなたの名前>`をご自身の名前に置き換えてください。 ## GitHubに変更をpushする `git push`コマンドを使って変更をpushしてください。 ``` git push origin <ブランチ名> ``` `<ブランチ名>`には先ほど作成したブランチ名を入れてください。 ## レビューのためにプルリクエストを送る GitHub上であなたのリポジトリに行くと、`Compare & pull request`ボタンが表示されます。そのボタンをクリックしてください。 create a pull request プルリクエストを作ってください。 submit pull request すぐに私が加えられた変更をmainブランチにマージします。マージが終了した際にはその旨のメールが送られます。 ## 次に何をするべきか おめでとうございます! コントリビューターとして重要な _フォーク -> クローン -> 編集 -> プルリクエスト_ の基本的なワークフローが完了しました。 初のオープンソースへの貢献を祝って友達やフォロワーにそのことを[このウェブアプリ](https://firstcontributions.github.io/#social-share)を使ってシェアしましょう。 もし何かしら質問があるようでしたら[私たちのSlack team](https://firstcontributors.slack.com/join/shared_invite/enQtMzE1MTYwNzI3ODQ0LTZiMDA2OGI2NTYyNjM1MTFiNTc4YTRhZTg4OWZjMzA0ZWZmY2UxYzVkMzI1ZmVmOWI4ODdkZWQwNTM2NDVmNjY)に入ってください。 他のプロジェクトへの貢献を始めましょう。簡単なイシューが立てられているプロジェクトのリストを作りました。ウェブアプリで[プロジェクトリスト](https://firstcontributions.github.io/#project-list)を確認て見てください。 ### [追加リソース](../additional-material/git_workflow_scenarios/additional-material.md) ## その他のツールを使用したチュートリアル | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | --- | --- | --- | --- | --- | --- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) |