I think it's a good idea to encourage other projects. I read the page and
it very well describes the effects such tags might have (from our
experience)

One proposal - I have not seen how projects that are already doing it might
be used as "good examples" - but I think we will be happy to share our
(good) experiences - and it might be a good thing to refer to some other
projects whe are already doing it - for example we could add "Project X is
doing it for years, if you want to see effect of it - here is the link, and
you can go talk to them - for example on devlist or on #issue-triage
channel on their slack etc. ). Happy to add such links to the wiki if you
think it is a good idea. Those projects might get "mentoring" or rather
"lead by example" function in the process.

For example I know that most of the projects from the "data engineering"
area that are close to us already follow that:  Apache Airflow, Apache
Beam, Apache Superset, Apache Iceberg - are all actively marking issues as
"good first issues" during their triaging.
I don't speak for others but our experience is very positive - people are
actually actively looking and "grabbing" such "good first issues" - we also
use them during our contribution workshops and in talks when we are
encouraging people to contribute.

Also it might be worth mentioning that for those projects (so pretty much
everyone) that use Github, the "good first issue" is already part of the
Github Ecosystem and tagging issues with "good first issue" label taps into
to that. This is also why it is part of the standard process of triaging
issues by a number of projects. it is also is supported and encouraged by
Github in their "Building Communities" documentations -
https://docs.github.com/en/communities/setting-up-your-project-for-healthy-contributions/encouraging-helpful-contributions-to-your-project-with-labels.
So it's worth to be aware that we are not reinventing the wheel and opening
doors, but rather we are telling our projects how they can tap into even
bigger ecosystem that is already there.

So it's not just a "label" - it also makes the issues automatically
discoverable and surfaced by other mechanisms that already understand that
"good first issue" is the way by which projects mark issues as - indeed -
good first issues to contribute as a GitHub standard.

For example all issues marked this way automatically land in the "
*contribute*" page of the project. This page has links to contribution
guidelines if projects have them and are often referred to by any sites
that have advice for people to start contributing. And the more projects
will start using it, the more "obvious" it will be for contributors that
they can use it. It might be even worth it to see how many projects already
follow it. Here are the pages from the projects I mentioned

* https://github.com/apache/beam/contribute
* https://github.com/apache/airflow/contribute
* https://github.com/apache/superset/contribute
* https://github.com/apache/iceberg/contribute

Those page also contain a nice explanation and encouragement explaining
what it is all about:

> Make your first contribution to this repository by tackling one of the
issues listed below.
> Read the contributing guidelines
> Each issue displayed here is a "good first issue," selected for its
relative approachability for first-time contributors.

J,

On Wed, Nov 1, 2023 at 11:36 PM Gláucia Esppenchutz <glauesp...@apache.org>
wrote:

> Hi everyone!
>
> In the last BoF, we discussed the possibility of creating and assigning a
> "good first issue" to some Apache projects and attracting newcomers.
> I made a small wiki page with this topic, covering the motivation, the
> objective, and how we can start it.
> You can find it here:
> https://cwiki.apache.org/confluence/pages/viewpage.action?pageId=278465058
>
> Please let me know what you think.
> I will start doing some research on the Apache reports to try to identify
> potential participants.
> I believe one of the incubator projects (Wayang) might be already
> interested, but let me know if they can participate.
> Have a lovely evening!
>
> Gláucia
>

Reply via email to