What are “Good First Issues”?

“Good First Issues” are a good way to start on an OSS project, and an official Github initiative. Several GitHub repositories use this label to encourage new contributors to start helping the project without the necessity, in most cases, to contact one of the contributors in advance or to have a deep knowledge of the project architecture or content.

How can I identify a “Good First Issue”?

“Good First Issues”’s are usually flagged in the GitHub projects and normally simple tasks that can be accomplished detached from other dependencies. It can be a small code enhancement, documenting internal functions, creating small APIs to connect services, documentation, and others.

Rather than simply tagging the issue as a “good first issue”, consider taking time to explain in detail exactly what needs to be done, and give suggestions of how you might do it.

Wouldn’t it be easier to fix it myself?

The point of the “good first issue” is that it is an investment in future contributors, and, thus, in the sustainability of the project. While it would, indeed, probably be easier to fix it yourself, investing the time to document what needs to be done, and how it might be done, is a way to engage a potential new contributor.

It’s a good idea to put contact information in the ticket, so that someone that wants to work on it, but lacks the confidence to do it, can get in touch with you and ask for help. Remember that this is not primarily about fixing the issue, but is about mentoring a new contributor in small ways, so that they can, eventually, become a productive member of the project.

Example first issues

Here you can find some Apache projects with “Good First Issues”: