From 58a74f90b7470e94e1cd9c8f45c6d02e5c5b7ea3 Mon Sep 17 00:00:00 2001 From: Ashish Gajanan Bhosale Date: Thu, 6 Aug 2026 11:34:13 +0530 Subject: [PATCH 1/2] docs: reference contributors-invite (issue #7546)\n\nAdd a short reference to the contributors invitation issue so prospective contributors can find onboarding guidance.\n\nCo-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --- CONTRIBUTING.md | 2 ++ README.md | 2 ++ 2 files changed, 4 insertions(+) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index f2f8dd9ffdea..268a1dcfd9b7 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -1,5 +1,7 @@ ## How to contribute? +Looking for contributors: This repository and related organizations are seeking contributors for project setup, documentation, CI, tests, and small features. See issue #7546 for the full invitation and list of organizations: https://github.com/TheAlgorithms/Java/issues/7546 + NOTE: *We DO NOT add leetcode problems. They are just applications of basic principles that can be found in other algorithms included in the repository.* ### Did you find a bug? diff --git a/README.md b/README.md index d60d5104c385..c0ad113464bf 100644 --- a/README.md +++ b/README.md @@ -16,5 +16,7 @@ These implementations are intended for learning purposes. As such, they may be l ## Contribution Guidelines Please read our [Contribution Guidelines](CONTRIBUTING.md) before you contribute to this project. +Looking for contributors? See issue #7546 — [Contributors Wanted for New Open-Source Projects](https://github.com/TheAlgorithms/Java/issues/7546) for details and ways to get involved. + ## Algorithms Our [directory](DIRECTORY.md) has the full list of applications. From c7a00ccaf9d582ff9e9f38e52e7d9cb4adfd5523 Mon Sep 17 00:00:00 2001 From: Ashish Gajanan Bhosale Date: Thu, 6 Aug 2026 11:35:48 +0530 Subject: [PATCH 2/2] feat: add good-first-issue template and contributor starter checklist (issue #7546)\n\nProvide a small onboarding template and starter checklist to make it easier for new contributors to open focused PRs.\n\nCo-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --- .github/ISSUE_TEMPLATE/good_first_issue.yml | 46 +++++++++++++++++++++ CONTRIBUTOR_STARTER.md | 30 ++++++++++++++ 2 files changed, 76 insertions(+) create mode 100644 .github/ISSUE_TEMPLATE/good_first_issue.yml create mode 100644 CONTRIBUTOR_STARTER.md diff --git a/.github/ISSUE_TEMPLATE/good_first_issue.yml b/.github/ISSUE_TEMPLATE/good_first_issue.yml new file mode 100644 index 000000000000..c94d18081f43 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/good_first_issue.yml @@ -0,0 +1,46 @@ +name: "Good first issue" +about: "A small, self-contained task suitable for new contributors. Follow the steps and submit a small PR." +title: "Good first issue: [short description]" +labels: ["good first issue", "help wanted"] +assignees: [] +body: + - type: markdown + attributes: + value: | + Thank you for helping! This template describes a small task that is suitable for a new contributor. + - type: input + id: description + attributes: + label: "What needs to be done?" + description: "Provide a concise description of the change required and why." + placeholder: "Add examples to README for X; implement unit tests for Y; fix typo in Z." + required: true + - type: input + id: acceptance_criteria + attributes: + label: "Acceptance criteria" + description: "List the checks that will show the task is complete (tests, example run, docs updated)." + placeholder: "1) README has code example; 2) Tests pass on CI" + required: true + - type: textarea + id: steps + attributes: + label: "Suggested steps" + description: "Optional step-by-step guidance for contributors." + placeholder: "1) Fork repo; 2) Create branch; 3) Make changes; 4) Run tests; 5) Open PR." + required: false + - type: dropdown + id: difficulty + attributes: + label: "Difficulty" + options: + - "low" + - "medium" + - "high" + description: "Estimate the difficulty for this task." + required: true + - type: input + id: related_issues + attributes: + label: "Related issues or references" + required: false diff --git a/CONTRIBUTOR_STARTER.md b/CONTRIBUTOR_STARTER.md new file mode 100644 index 000000000000..6c8b727e4447 --- /dev/null +++ b/CONTRIBUTOR_STARTER.md @@ -0,0 +1,30 @@ +Contributor starter template + +This small template provides minimal files and guidance that can be used to initialize a new repository or provide a starter PR for an empty project. + +Suggested files to add in a starter PR: +- README.md: Short project description, purpose, quick start, and how to contribute. +- CONTRIBUTING.md: Minimal contribution flow (fork -> branch -> PR), coding style notes, testing instructions. +- .github/ISSUE_TEMPLATE/good_first_issue.yml: Template for small tasks for new contributors (already added here). +- LICENSE: e.g., MIT or Apache-2.0. +- .github/workflows/build.yml: Basic CI to run tests on push/PR (optional). + +Quick README example: + +# ProjectName + +Short one-line description. + +## Getting started + +1. Fork the repository +2. Build with: mvn -q -DskipTests package +3. Run tests: mvn -q test + +## Contributing + +See CONTRIBUTING.md and look for issues labeled `good first issue`. + +--- + +Use this file as a checklist when opening an initial "starter" PR for a new repo. Keep the PR small and focused on onboarding (docs + ci), not large feature work.