Adoptium では、オープンソース、Java、および Java コミュニティに人々が参加できるよう支援したいと考えています。 そのため、オープンソースの活動を始めたい方への支援が非常に重要だと考えています。
Note
このドキュメントはまだ作業中であり、記載されている一部の内容は、まだ確立されていない将来のアイデアです。
Adoptium では、https://github.com/orgs/adoptium/projects/[good first issue] とラベルが付いた Issue を複数提供しています。 これらの Issue はすべて、オープンソースプロジェクトへの貢献を始めるのに最適です。 Issue にはわかりやすい説明と、すぐに作業を始めるための多くの役立つドキュメントやチュートリアルへのリンクが含まれています。 GitHub 全般に詳しくない場合でも、フォークとプルリクエストのワークフローを理解するためのわかりやすいチュートリアルへのリンクが Issue に含まれています。
GitHub では good first issue とラベルが付いたすべての Issue のリスト を確認できます。
テンプレート
現在、https://github.com/orgs/adoptium/projects/[good first issue] とラベルが付けられた Issue 向けの Issue テンプレートに取り組んでいます。 現在のバージョンの Issue テンプレート と contributing.md ファイルへの「初心者サポート」セクション は現在開発中です。
good first issue を作成するワークフロー
Issue が good first issue になる可能性があると判断した場合は、good first issue - candidate ラベルを付けてください。
そうすることでレビューされ、https://github.com/orgs/adoptium/projects/[good first issue] になるよう修正できます。
GitHub では good first issue - candidate とラベルが付いたすべての Issue のリスト を確認できます。
good first issue - candidate とラベルが付いたすべての Issue はレビューされ、必要に応じて good first issue ラベルが付けられる Issue になるよう改良されるべきです。
以下のルールを適用する必要があります:
-
Issue のタイトルは問題を明確に示すものであること
-
Issue の説明は
good first issueテンプレート に基づくこと -
Issue にはコメントを含めないこと。コメントがあると初心者には理解しにくくなります。 コメントにある関連情報はすべて Issue の説明に追加してください。 その後、コメントは削除してください。 これが不可能な場合は、https://github.com/orgs/adoptium/projects/[good first issue] 用に新しい Issue を作成し、元の Issue にリンクして元の Issue をクローズするのが最善策です。
-
Issue の説明を作成する際は、初心者が作業を始めるための適切な出発点を見つけられるよう、ドキュメントや役立つファイル（コードへの直接リンクも可）へのリンクを含めることが常に重要です。
Issue が改良されレビューされたら、https://github.com/orgs/adoptium/projects/[good first issue] とラベルを付け、good first issue - candidate ラベルを削除してください。
あわせて、これらの Issue に help wanted と Hacktoberfest のラベルも付けてください。
