Hi Jarek,

Thank you for the response, and I apology for the late reply.

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.


I would appreciate it if you add the links and any other thoughts here.
Feel free to do it; this is live documentation!


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.

I will add this info to the wiki!

I am glad I addressed the relevance of this initiative in the wiki; this
was my main concern.
Now that I have finished most of my Master's activities, I will come back
to this subject.

Team, please let me know if anyone also has any considerations.

Best
Gláucia

Em qua., 1 de nov. de 2023 às 23:31, Jarek Potiuk <ja...@potiuk.com>
escreveu:

> 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
> >
>


-- 
Gláucia Esppenchutz

-----------------------------------------------------
Twitter: @lyuric19
Linkedin: https://br.linkedin.com/pub/gláucia-esppenchutz/47/81a/312

Reply via email to