terriko / good-first-issue

Make your first open-source contribution.

---

Welcome! 👋🏼

Good First Issue is an initiative to curate easy pickings from popular projects, so developers who've never contributed to open-source can get started quickly.

Open-source maintainers are always looking to get more people involved, but new developers generally think it's challenging to become a contributor. We believe getting developers to fix super-easy issues removes the barrier for future contributions. This is why Good First Issue exists.

Adding a new project

You're welcome to add a new project in Good First Issue, and we encourage all projects — old and new, big and small.

Follow these simple steps:

• Our goal is to narrow down projects for new open-source contributors. To maintain the quality of projects in Good First Issue, please make sure your GitHub repository meets the following criteria:

  • At least three issues with the good first issue label. This label is already present on all repositories by default. If not, you can follow the steps here.

  • At least 10 contributors.

  • Detailed setup instructions for the project.

  • CONTRIBUTING.md

  • Actively maintained.

• Add your repository's path (in lexicographic order) in data/repositories.toml.

• Create a new pull-request. Please add the link to the issues page of the repository in the PR description. Once the pull request is merged, the changes will be live on goodfirstissue.dev.

We hangout in our Discord server. Stop by to say hi! 🙌🏼