CINXE.COM
Apache Community Development - Good First Issues
<!DOCTYPE html> <html lang="en"> <head> <meta name="description" content="Apache Community Development"/> <meta name="keywords" content="apache, apache community, community development, opensource"/> <meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1" /> <meta property="og:title" content="Good First Issues" /> <meta property="og:description" content="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”?" /> <meta property="og:type" content="article" /> <meta property="og:url" content="https://community.apache.org/committers/good-first-issues.html" /><meta property="og:image" content="https://community.apache.org/images/project-logos.webp"/><meta property="article:section" content="committers" /> <meta property="og:site_name" content="Apache Community Development" /> <title>Apache Community Development - Good First Issues</title> <link rel="shortcut icon" href="/images/favicon.ico"> <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <link href="/css/main.css" rel="stylesheet" media="screen"> <link href="/css/bootstrap.min.css" rel="stylesheet" media="screen"> <style type="text/css"> .footer { text-align:center; color:grey; font-size:80%; border-top: solid #ddd 1px; margin-top:1em; } .navbar-brand img { height: 50px; } </style> <script> var _paq = window._paq = window._paq || []; _paq.push(['disableCookies']); _paq.push(['trackPageView']); _paq.push(['enableLinkTracking']); (function() { var u="https://analytics.apache.org/"; _paq.push(['setTrackerUrl', u+'matomo.php']); _paq.push(['setSiteId', '36']); var d=document, g=d.createElement('script'), s=d.getElementsByTagName('script')[0]; g.async=true; g.src=u+'matomo.js'; s.parentNode.insertBefore(g,s); })(); </script> </head> <body> <header class="navbar navbar-expand-lg navbar-dark bg-bright fixed-top"> <div class="container"> <a class="navbar-brand" href="/"> <img src="/images/asf_logo.svg" alt="Apache Software Foundation"> </a> <button class="navbar-toggler" type="button" data-toggle="collapse" data-target="#mainNavbar" aria-controls="mainNavbar" aria-expanded="false" aria-label="Toggle navigation"> <span class="navbar-toggler-icon"></span> </button> <div class="collapse navbar-collapse" id="mainNavbar"> <div class="container"> <ul class="navbar-nav mr-auto"> <li class="nav-item dropdown"> <a class="nav-link dropdown-toggle" href="#" id="homeDropdown" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false"> Home </a> <div class="dropdown-menu" aria-labelledby="homeDropdown"> <a class="dropdown-item" href="/">Homepage</a> <a class="dropdown-item" href="/tags.html">Tags</a> <a class="dropdown-item" href="/blog/">Blog</a> <a class="dropdown-item" href="/tags/navigation.html">Navigation pages</a> </div> </li> <li class="nav-item dropdown"> <a class="nav-link dropdown-toggle" href="#" id="aboutDropdown" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false"> About </a> <div class="dropdown-menu" aria-labelledby="aboutDropdown"> <a class="dropdown-item" href="/about/">What We Do</a> <a class="dropdown-item" href="/newbiefaq.html">Frequently Asked Questions</a> <a class="dropdown-item" href="/projectIndependence.html">Apache Project Independence</a> <a class="dropdown-item" href="/apache-way/apache-project-maturity-model.html">Apache Project Maturity Model</a> <a class="dropdown-item" href="/contactpoints.html">Contact Points Within the ASF</a> <a class="dropdown-item" href="https://whimsy.apache.org/board/minutes/Community_Development.html#2009-11-01">ComDev Original Board Resolution</a> <a class="dropdown-item" href="https://whimsy.apache.org/board/minutes/Community_Development.html">ComDev Board Reports</a> <a class="dropdown-item" href="https://issues.apache.org/jira/projects/COMDEV">Community Development Jira</a> <div class="dropdown-divider"></div> <a class="dropdown-item text-uppercase disabled" href="#">About Apache</a> <a class="dropdown-item" href="https://www.apache.org/">The Apache Software Foundation</a> <a class="dropdown-item" href="https://www.apache.org/foundation/sponsorship">Sponsor Apache</a> <a class="dropdown-item" href="http://diversity.apache.org/">Diversity & Inclusion</a> <a class="dropdown-item" href="/contributors/asf-volunteers.html">Mentors & Speakers</a> <a class="dropdown-item" href="https://www.apache.org/foundation/thanks">Thanks to our Sponsors</a> <a class="dropdown-item" href="https://www.apache.org/licenses">License</a> <a class="dropdown-item" href="https://www.apache.org/security">Security</a> </div> </li> <li class="nav-item dropdown"> <a class="nav-link dropdown-toggle" href="#" id="contribDropdown" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false"> Contributing </a> <div class="dropdown-menu" aria-labelledby="contribDropdown"> <a class="dropdown-item" href="/contributor-ladder.html">Contributor Ladder</a> <a class="dropdown-item" href="/newcomers/">Getting Started at Apache</a> <a class="dropdown-item" href="/contributors/">Contributing to projects</a> <a class="dropdown-item" href="/committers/">Committers</a> <a class="dropdown-item" href="/pmc/">PMC Members</a> <div class="dropdown-divider"></div> <a class="dropdown-item text-uppercase disabled" href="#">Committer and PMC Information</a> <a class="dropdown-item" href="https://www.apache.org/dev/">Technical Developer FAQs</a> <a class="dropdown-item" href="/committers/decisionMaking.html">Decision Making</a> <a class="dropdown-item" href="/committers/good-first-issues.html">Good First Issues</a> <a class="dropdown-item" href="/pmc/community-growth.html">Recruiting New Contributors</a> </div> </li> <li class="nav-item dropdown"> <a class="nav-link dropdown-toggle" href="#" id="commitDropdown" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">GSoC</a> <div class="dropdown-menu" aria-labelledby="gsocDropdown"> <a class="dropdown-item" href="/gsoc/">Google Summer Of Code Information</a> <a class="dropdown-item" href="/gsoc/mentee-ranking-process.html">Mentee Ranking Process</a> <a class="dropdown-item" href="/gsoc/experiences/">Past GSoC Experiences</a> <a class="dropdown-item" href="/gsoc/guide-to-being-a-mentor.html">Guide to being a Mentor</a> <a class="dropdown-item" href="/gsoc/use-the-comdev-gsoc-issue-tracker-for-gsoc-tasks.html">Using ComDev's Jira for GSoC Ideas</a> <a class="dropdown-item" href="/gsoc/gsoc-admin-tasks.html">Tasks of a GSoC Admin at the ASF</a> <a class="dropdown-item" href="https://issues.apache.org/jira/projects/GSOC">GSoC Jira</a> </div> </li> <li class="nav-item dropdown"> <a class="nav-link dropdown-toggle" href="#" id="eventDropdown" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false"> Events </a> <div class="dropdown-menu" aria-labelledby="eventDropdown"> <a class="dropdown-item" href="https://apachecon.com/">Community Over Code - (formerly ApacheCon)</a> <a class="dropdown-item" href="https://events.apache.org/">Other Apache-related Events</a> <a class="dropdown-item" href="https://www.apache.org/foundation/marks/events">Apache event branding policies</a> <div class="dropdown-divider"></div> <a class="dropdown-item text-uppercase disabled" href="#">Conference Speakers</a> <a class="dropdown-item" href="/speakers/">Speaker resources</a> <a class="dropdown-item" href="/speakers/slides.html">Sample presentations</a> </div> </li> <li class="nav-item dropdown"> <a class="nav-link dropdown-toggle" href="#" id="conversDropdown" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false"> Working Groups </a> <div class="dropdown-menu" aria-labelledby="wgDropdown"> <a class="dropdown-item" href="/workinggroups/">Working Groups</a> <a class="dropdown-item" href="https://github.com/apache/comdev-working-groups">Git repositories</a> </div> </li> <li class="nav-item dropdown"> <a class="nav-link dropdown-toggle" href="#" id="conversDropdown" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false"> Join the Conversation </a> <div class="dropdown-menu" aria-labelledby="conversDropdown"> <a class="dropdown-item" href="/blog/">Blog</a> <a class="dropdown-item" href="https://www.facebook.com/ApacheSoftwareFoundation">Facebook</a> <a class="dropdown-item" href="https://twitter.com/ApacheCommunity">Twitter</a> <a class="dropdown-item" href="/lists.html">Mailing List</a> <a class="dropdown-item" href="https://cwiki.apache.org/confluence/display/COMDEV/Apache+Local+Community+-+ALC">ALC: Apache Local Communities</a> </div> </li> </ul> </div> </div> </div> </header> <main class="cd-main" id="content" role="main"> <div class="container"> <section id="content" class="row"> <div class="col-md-9"> </div> <div class="col-md-12"></div> </section> <hr> <ul class="tags-list"> <li> <a href="https://community.apache.org/tags/inclusion.html">inclusion</a> </li> <li> <a href="https://community.apache.org/tags/diversity.html">diversity</a> </li> <li> <a href="https://community.apache.org/tags/newcomers.html">newcomers</a> </li></ul> <br><br> <h1 id="what-are-good-first-issues">What are “Good First Issues”? <a class="headerlink" title="Permalink" href="#what-are-good-first-issues">¶</a></h1> <p>“Good First Issues” are a good way to start on an OSS project, and an <a href="https://github.com/topics/good-first-issue">official Github initiative</a>. 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.</p> <h3 id="how-can-i-identify-a-good-first-issue">How can I identify a “Good First Issue”? <a class="headerlink" title="Permalink" href="#how-can-i-identify-a-good-first-issue">¶</a></h3> <p>“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.</p> <p>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.</p> <h3 id="wouldnt-it-be-easier-to-fix-it-myself">Wouldn’t it be easier to fix it myself? <a class="headerlink" title="Permalink" href="#wouldnt-it-be-easier-to-fix-it-myself">¶</a></h3> <p>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.</p> <p>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.</p> <h3 id="example-first-issues">Example first issues <a class="headerlink" title="Permalink" href="#example-first-issues">¶</a></h3> <p>Here you can find some Apache projects with “Good First Issues”:</p> <ul> <li><a href="https://github.com/apache/airflow/contribute">Apache Airflow</a></li> <li><a href="https://github.com/apache/beam/contribute">Apache Beam</a></li> <li><a href="https://issues.apache.org/jira/browse/CASSANDRA-18868?jql=project%20%3D%20Cassandra%20AND%20(complexity%20%3D%20%22Low%20Hanging%20Fruit%22%20or%20labels%20%3D%20%22lhf%22)%20and%20assignee%20is%20Empty%20and%20status%20not%20in%20(Resolved%2C%20%22In%20Progress%22)">Apache Cassandra</a></li> <li><a href="https://github.com/apache/iceberg/contribute">Apache Iceberg</a></li> <li><a href="https://s.apache.org/for-the-grabs_maven">Apache Maven</a></li> <li><a href="https://github.com/apache/superset/contribute">Apache Superset</a></li> </ul> </div> </main> <footer class="page-footer bg-secondary mt-4 pt-3"> <div class="container text-center text-md-left mb-3"> <div class="row"> <div class="col-md-6 mt-md-0 mt-3"> <h5 class="text-uppercase">Trademarks</h5> <p> Apache®, the names of Apache projects, and the multicolor feather logo are <a href="https://www.apache.org/foundation/marks/list/">registered trademarks or trademarks</a> of the Apache Software Foundation in the United States and/or other countries. </p> </div> <hr class="clearfix w-100 d-md-none pb-3"> <div class="col-md-6 mb-md-0 mb-3"> <h5 class="text-uppercase">Website sources</h5> <p> This website is generated from the <a href="https://github.com/apache/comdev-site">comdev-site repository</a> <br/> Source of this page: <a href="https://github.com/apache/comdev-site/blob/main/source/committers/good-first-issues.md" title="Source of this page"> committers/good-first-issues.md </a> </p> </div> </div> </div> <div class="footer-copyright text-center py-3"> <em>Copyright © 2024, <a href="https://www.apache.org/">the Apache Software Foundation</a>. Licensed under the <a rel="license" href="https://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a></em> </div> </footer> <script src="/js/jquery.min.js"></script> <script src="/js/bootstrap.min.js"></script> </body> </html>