From the beginning, GitLab has been an open source project and we want to continue growing community code contribution. This will be accomplished by lowering the barrier to entry for new contributors and also by helping casual contributors become regular contributors. We want GitLab to be the open source project of choice for open source developers.
A GitLab community room is available on Gitter for people interested in contributing to GitLab. This is open to everyone to join.
There will be a quarterly Hackathon for GitLab community members to come together to work on merge requests, participate in tutorial sessions, and support each other on the GitLab community channel. Agenda, logistics, materials, recordings, and other information for Hackathons will be available on the Hackathon project pages.
The event planning will be done following the Hackathon checklist
The GitLab Bot labels merge requests from outside of GitLab with the label Community contribution once a day (Monday-Friday). If you subscribe to the label, you will also receive an email notification from the GitLab Bot. It's helpful to review these MRs to do some quick triaging to apply appropriate labels and mention GitLab team members (e.g. product managers, engineering managers, technical writers for documentation, etc. ) so that the community MRs can be reviewed in a timely manner. You can refer to the product team handbook for the list of people you can mention in merge requests for each product area.
After the first merged MR, make an offer using an outreach email template to pair the new contributor with an experienced mentor from the community. This is for a limited time period only (2 weeks) so that mentors are not overly burdened. Currently, the mentors consist primarily of Core Team members.
The first-time contributors can be identified after each release in the First time contributors MRs dashboard.
There will be a monthly call with members of the Core Team using the Zoom conferencing tool and meetings will also be recorded. Since Core Team members are spread out in different time zones, meeting times will be rotated.
Service Desk will be used as a communication tool for Core Team members. Anyone can open issues in the Service Desk or send an email to incoming+gitlab-core-team/general@incoming.gitlab.com Core Team members who signed NDAs will also have access to GitLab Slack channels.
In order for community contributors to contribute to the GitLab Enterprise Edition, they will need a license for EE. If they don't already have a license, they can get a free trial for 30 days. If the contributor is not able to complete their work in 30 days, issue a new EE license for a 3-month period for a limited number of users. If the contributor wants to continue contributing to EE beyond the 3 months (and there has been contributions during the 3-month period), we can renew the license for another 3-month period.
In order to request license keys for EE, you will need to get permission to login to dev.gitlab.org by creating an access request issue. Details on requesting license keys can be found at Working on GitLab EE section of the developer onboarding handbook.
Goal is to publish a regular blog post featuring contributors from the community. The format will be a casual Q&A with a community member and will be posted on the GitLab blog page.
When developing a blog post, follow the blog guidelines.
Periodically, there should be a review of community MR's that has not had a meaningful activity for an extended period (e.g. >3 months). A good place to start would be to search for all MR's with a label Community contribution and a milestone No milestone. A follow-up should be made with either the community member or MR coaches to ask if there's a plan to continue work on the MR or if MR should be closed.
Note: this is currently a working list of all locations where we can currently gather contributor metrics. It is not yet the final set of metrics we will be using to monitor the success of the contributor program with.
The Bitergia dashboard is public and anyone can use the dashboard to view/filter/export/analyze the data. A good place to start is the Merged Community MRs dashboard as it includes information that most people are looking for such as merged community MRs, number of contributors (e.g. yearly), top contributors, merged MRs per milestone, etc. You can filter the dashboard data per milestone and repository (e.g. CE vs. EE).
There are a number of other custom dashboards also available and to see the full list, click on dashboard on the upperleft (next to the Bitergia logo) and then select the dashboard link from the list. To learn more about using the Bitergia dashboard, you can view recordings of Bitergia training at the Bitergia training livestream channel.
Some administrative features (e.g. getting a short URL, creating a new dashboard) require a login, and the login information is available in the Team Vault on 1Password.
The Quality team publishes a monthly dashboard with the data update on the 4th Monday of each month. The Community MRs per release tab shows merged MRs from the wider community.
You can also directly query data from Merge Requests pages for projects (e.g. CE, EE, Gitter, Omnibus, Shell, etc.) on gitlab.com and aplly appropriate filters for milestone, labels, etc. Some of the examples are listed in the metrics table below.
NOTE: "GitLabbers included" column
| METRIC | TIME SERIES | PROJECT | DATA SOURCE | GITLABBERS INCLUDED? | NOTES |
|---|---|---|---|---|---|
| Release | GitLab CE/EE | Bitergia dashboard | ✖ | - | |
| No. of merged contributions | Release | GitLab CE | Quality dashboard | ✖ | To be phased out in favour of the Bitergia Dashboard |
| No. of contributors | All time | GitLab CE | GitLab contributors app | ✓ | - |
| No. of merged contributions | All time | GitLab CE | Community contribution label | ✖ | - |
| No. of merged contributions | All time | GitLab organization | Community contribution label | ✖ | - |
| No. of open contributions | All time | GitLab organization | Community contribution label | ✖ | - |
| No. of merged contributions | All time | GitLab CE | Community contribution label | ✖ | - |
| No. of open contributions | All time | GitLab CE | Community contribution label | ✖ | - |
| No. of WIP open contributions | All time | GitLab CE | Community contribution label | ✖ | - |
| No. of merged contributions | All time | GitLab EE | Community contribution label | ✖ | - |
| No. of open contributions | All time | GitLab EE | Community contribution label | ✖ | - |
We generally gather data from the GitLab CE & EE projects. However, there are other projects contributors can submit merge requests to:
Additional projects:
