[openstack-dev] Encouraging first-time contributors through bug tags/reviews
Shamail
itzshamail at gmail.com
Wed Nov 25 20:22:48 UTC 2015
Hi,
> On Nov 25, 2015, at 11:05 PM, Doug Hellmann <doug at doughellmann.com> wrote:
>
> Excerpts from Shamail Tahir's message of 2015-11-25 09:15:54 -0500:
>> Hi everyone,
>>
>> Andrew Mitry recently shared a medium post[1] by Kent C. Dobbs which
>> discusses how one open-source project is encouraging contributions by new
>> open-source contributors through a combination of a special tag (which is
>> associated with work that is needed but can only be completed by someone
>> who is a first-time contributor) and helpful comments in the review phase
>> to ensure the contribution(s) eventually get merged.
>>
>> While reading the article, I immediately thought about our
>> low-hanging-fruit bug tag which is used for a very similar purpose in "bug
>> fixing" section of the "how to contribute" page[2]. The low-hanging-fruit
>> tag is used to identify items that are generally suitable for first-time or
>> beginner contributors but, in reality, anyone can pick them up.
>>
>> I wanted to propose a new tag (or even changing the, existing, low-hanging
>> fruit tag) that would identify items that we are reserving for first-time
>> OpenStack contributors (e.g. a patch-set for the item submitted by someone
>> who is not a first time contributor would be rejected)... The same article
>> that Andrew shared mentions using an "up-for-grabs" tag which also
>> populates the items at up-for-grabs[3] (a site where people looking to
>> start working on open-source projects see entry-level items from multiple
>> projects). If we move forward with an exclusive tag for first-timers then
>> it would be nice if we could use the up-for-grabs tag so that OpenStack
>> also shows up on the list too. Please let me know if this change should be
>> proposed elsewhere, the tags are maintained in launchpad and the wiki I
>> found related to bug tags[4] didn't indicate a procedure for submitting a
>> change proposal.
>
> I like the idea of making bugs suitable for first-timers more
> discoverable. I'm not sure we need to *reserve* any bugs for any class
> of contributor. What benefit do you think that provides?
I would have to defer to additional feedback here...
My own perspective from when I was doing my first contribution is that it was hard to find active "low-hanging-fruit" items. Most were already work-in-progress or assigned.
The idea was that having a reserved set of bugs would ensure that there was always something that could be discovered easily and would be available. If we could make available low-hanging-fruit more discoverable then that would possibly mitigate the need for "reserved" bugs. We have enough items to work on where availability shouldn't be an issue, just visibility.
https://bugs.launchpad.net/openstack/+bugs?field.tag=low-hanging-fruit&orderby=status&start=0
>
>>
>> Tyler Britten also suggested maybe even having a pool of reviewers who
>> could monitor items being worked on that fall in this "first-timer"
>> category who could further help the new contributors by helpful review
>> comments and answering questions if the contributors get stuck on some part
>> of the process. Could this be the same people who helped make the upstream
>> training[5] successful? I look forward to thoughts on this matter.
>
> If we have volunteers willing to do this, that's great. It's not
> obvious, but it is actually possible to query gerrit for reviews
> from first-time contributors. A bot A watches for new patches leaves
> a comment on any for which the submitter has not previously submitted
> a patch. Querying for open reviews with comments from that bot is
> straightforward once you know its gerrit id. For example, this URL
> will show all open patches from first-time contributors submitted
> to any repository:
>
> https://review.openstack.org/#/q/reviewer:10068+is:open,n,z
Thanks Doug! I'll definitely start monitoring the results of this query and help when possible. It will be great if others do it too, the more the merrier.
>
> Doug
>
>>
>> [1] https://medium.com/@kentcdodds/first-timers-only-78281ea47455#.707dal290
>> [2] https://wiki.openstack.org/wiki/How_To_Contribute#Bug_fixing
>> <https://wiki.openstack.org/wiki/How_To_Contribute#Bug_fixing>
>> [3] http://up-for-grabs.net/
>> [4] https://wiki.openstack.org/wiki/Bug_Tags
>> [5] http://docs.openstack.org/upstream-training/
>
> __________________________________________________________________________
> OpenStack Development Mailing List (not for usage questions)
> Unsubscribe: OpenStack-dev-request at lists.openstack.org?subject:unsubscribe
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
More information about the OpenStack-dev
mailing list