私たちのプロジェクトに興味を持っていただきありがとうございます!:sparkles:
Code of Conductを遵守し、当プロジェクトを快適で安全な状態に保つようお願いします。
ここではIssueやPR作成の手順、レビューに関すること、PRのマージに関する内容を記載しています。
当プログラムに何かしらバグを発見した場合、ぜひIssueを作成して私たちに知らせてください。公にするのが危険な脆弱性等の報告は、Issueを作成せず私たちのDiscordグループに参加し、サポートチケットを作成して報告してください。
また、あなたはIssueを用いて単に機能追加をリクエストすることもできます。その案を採用するかの決定は私たちに委ねられていることを理解した上でIssueを作成してください。
私たちのIssue一覧に解決すべきIssueが載せてあります。あなたはこの一覧の中の解決できそうなIssueに携わったり、自分に合うIssueが存在しない場合はコントリビュートを見送ることができます。
当プロジェクトは GitHub flow に従って開発されています。そのためブランチの名前は分かりやすい名前であることが求められます。例えばfeat/add-tell-cmd
やfix/issue-50
等は良い例です。
基本的な流れは以下の通りです。
-
IntelliJ IDEAを導入する
-
Google Java Styleを適用する
-
このリポジトリをフォークする
-
作業ブランチを作成してコードを書き換える
満足したタイミングで編集内容をコミットしましょう。コミットの際は https://gitmoji.dev/ を参考にして、コメントの先頭に絵文字でPrefixを付けましょう。また、編集した内容を簡潔にわかりやすくコメントします。
また、コミットメッセージは日本語が推奨されています。これは現状このプロジェクトに携わっているメンバーが全員日本人であり、英語で会話する利点が無いからです。
変更が終了したら、変更内容を自分で見直すことを忘れないでください。PRのレビューを迅速に行えるようにするためです。
コードの編集が完了したら、Pull Requestを作成しましょう。
- 既存のIssueに基づいた編集の場合はIssueとPRの紐付け(link PR to issue)を忘れずに行ってください。
- PRを出す際にallow maintainer editsにチェックを入れてください。
- コミットメッセージと同様の理由で、PRのタイトルやコメントは日本語が推奨されています。
- PRが提出されると、私たちは編集されたコードについて質問を行う場合があります。
- 同様に、私たちは編集されたコードについて修正を依頼する場合があります。あなたはWebUIから変更を適用することもできますし、あなたのフォークの内容を変更しPushすることで反映することもできます。
- もし何かしらマージについて問題を抱えている場合は、このgit tutorialを参考にしてみてください。
おめでとうございます!:tada: そしてありがとうございます!:sparkles:.
あなたのPRがマージされると、あなたの貢献はContributorsに公開されます。そして私たちからの感謝の気持ちを受け取ります ✨