Commit d6be7ed7 authored by Mek Stittri's avatar Mek Stittri

Merge branch 'docs-accepting-merge-requests-label-is-the-ssot' into 'master'

Make the 'Accepting merge requests' workflow consistent

See merge request gitlab-org/gitlab-ce!22467
parents 3e3d8f11 6192c0a5
...@@ -8,7 +8,7 @@ We want to create a welcoming environment for everyone who is interested in cont ...@@ -8,7 +8,7 @@ We want to create a welcoming environment for everyone who is interested in cont
For a first-time step-by-step guide to the contribution process, please see For a first-time step-by-step guide to the contribution process, please see
["Contributing to GitLab"](https://about.gitlab.com/contributing/). ["Contributing to GitLab"](https://about.gitlab.com/contributing/).
Looking for something to work on? Look for issues in the [Backlog (Accepting merge requests) milestone](#i-want-to-contribute). Looking for something to work on? Look for issues with the label [`Accepting merge requests`](#i-want-to-contribute).
GitLab comes in two flavors, GitLab Community Edition (CE) our free and open GitLab comes in two flavors, GitLab Community Edition (CE) our free and open
source edition, and GitLab Enterprise Edition (EE) which is our commercial source edition, and GitLab Enterprise Edition (EE) which is our commercial
...@@ -30,6 +30,11 @@ Please report suspected security vulnerabilities in private to ...@@ -30,6 +30,11 @@ Please report suspected security vulnerabilities in private to
Please do **NOT** create publicly viewable issues for suspected security Please do **NOT** create publicly viewable issues for suspected security
vulnerabilities. vulnerabilities.
## Code of conduct
Our code of conduct can be found on the
["Contributing to GitLab"](https://about.gitlab.com/contributing/) page.
## Closing policy for issues and merge requests ## Closing policy for issues and merge requests
GitLab is a popular open source project and the capacity to deal with issues GitLab is a popular open source project and the capacity to deal with issues
...@@ -61,10 +66,10 @@ the remaining issues on the GitHub issue tracker. ...@@ -61,10 +66,10 @@ the remaining issues on the GitHub issue tracker.
## I want to contribute! ## I want to contribute!
If you want to contribute to GitLab, [issues in the `Backlog (Accepting merge requests)` milestone][accepting-mrs-weight] If you want to contribute to GitLab,
are a great place to start. Issues with a lower weight (1 or 2) are deemed [issues with the `Accepting merge requests` label](issue_workflow.md#label-for-community-contributors)
suitable for beginners. These issues will be of reasonable size and challenge, are a great place to start.
for anyone to start contributing to GitLab. If you have any questions or need help visit [Getting Help](https://about.gitlab.com/getting-help/#discussion) to If you have any questions or need help visit [Getting Help](https://about.gitlab.com/getting-help/#discussion) to
learn how to communicate with GitLab. If you're looking for a Gitter or Slack channel learn how to communicate with GitLab. If you're looking for a Gitter or Slack channel
please consider we favor please consider we favor
[asynchronous communication](https://about.gitlab.com/handbook/communication/#internal-communication) over real time communication. Thanks for your contribution! [asynchronous communication](https://about.gitlab.com/handbook/communication/#internal-communication) over real time communication. Thanks for your contribution!
...@@ -126,4 +131,3 @@ This [documentation](style_guides.md) outlines the current style guidelines. ...@@ -126,4 +131,3 @@ This [documentation](style_guides.md) outlines the current style guidelines.
[team]: https://about.gitlab.com/team/ [team]: https://about.gitlab.com/team/
[getting-help]: https://about.gitlab.com/getting-help/ [getting-help]: https://about.gitlab.com/getting-help/
[codetriage]: http://www.codetriage.com/gitlabhq/gitlabhq [codetriage]: http://www.codetriage.com/gitlabhq/gitlabhq
[accepting-mrs-weight]: https://gitlab.com/gitlab-org/gitlab-ce/issues?scope=all&utf8=✓&state=opened&assignee_id=0&milestone_title=Backlog%20(Accepting%20merge%20requests)
...@@ -181,10 +181,10 @@ Severity levels can be applied further depending on the facet of the impact; e.g ...@@ -181,10 +181,10 @@ Severity levels can be applied further depending on the facet of the impact; e.g
Issues that are beneficial to our users, 'nice to haves', that we currently do Issues that are beneficial to our users, 'nice to haves', that we currently do
not have the capacity for or want to give the priority to, are labeled as not have the capacity for or want to give the priority to, are labeled as
~"Accepting Merge Requests", so the community can make a contribution. ~"Accepting merge requests", so the community can make a contribution.
Community contributors can submit merge requests for any issue they want, but Community contributors can submit merge requests for any issue they want, but
the ~"Accepting Merge Requests" label has a special meaning. It points to the ~"Accepting merge requests" label has a special meaning. It points to
changes that: changes that:
1. We already agreed on, 1. We already agreed on,
...@@ -192,26 +192,26 @@ changes that: ...@@ -192,26 +192,26 @@ changes that:
1. Are likely to get accepted by a maintainer. 1. Are likely to get accepted by a maintainer.
We want to avoid a situation when a contributor picks an We want to avoid a situation when a contributor picks an
~"Accepting Merge Requests" issue and then their merge request gets closed, ~"Accepting merge requests" issue and then their merge request gets closed,
because we realize that it does not fit our vision, or we want to solve it in a because we realize that it does not fit our vision, or we want to solve it in a
different way. different way.
We add the ~"Accepting Merge Requests" label to: We add the ~"Accepting merge requests" label to:
- Low priority ~bug issues (i.e. we do not add it to the bugs that we want to - Low priority ~bug issues (i.e. we do not add it to the bugs that we want to
solve in the ~"Next Patch Release") solve in the ~"Next Patch Release")
- Small ~"feature proposal" - Small ~"feature proposal"
- Small ~"technical debt" issues - Small ~"technical debt" issues
After adding the ~"Accepting Merge Requests" label, we try to estimate the After adding the ~"Accepting merge requests" label, we try to estimate the
[weight](#issue-weight) of the issue. We use issue weight to let contributors [weight](#issue-weight) of the issue. We use issue weight to let contributors
know how difficult the issue is. Additionally: know how difficult the issue is. Additionally:
- We advertise ["Accepting Merge Requests" issues with weight < 5][up-for-grabs] - We advertise [`Accepting merge requests` issues with weight < 5][up-for-grabs]
as suitable for people that have never contributed to GitLab before on the as suitable for people that have never contributed to GitLab before on the
[Up For Grabs campaign](http://up-for-grabs.net) [Up For Grabs campaign](http://up-for-grabs.net)
- We encourage people that have never contributed to any open source project to - We encourage people that have never contributed to any open source project to
look for ["Accepting Merge Requests" issues with a weight of 1][firt-timers] look for [`Accepting merge requests` issues with a weight of 1][firt-timers]
If you've decided that you would like to work on an issue, please @-mention If you've decided that you would like to work on an issue, please @-mention
the [appropriate product manager](https://about.gitlab.com/handbook/product/#who-to-talk-to-for-what) the [appropriate product manager](https://about.gitlab.com/handbook/product/#who-to-talk-to-for-what)
...@@ -220,12 +220,12 @@ members to further discuss scope, design, and technical considerations. This wil ...@@ -220,12 +220,12 @@ members to further discuss scope, design, and technical considerations. This wil
ensure that your contribution is aligned with the GitLab product and minimize ensure that your contribution is aligned with the GitLab product and minimize
any rework and delay in getting it merged into master. any rework and delay in getting it merged into master.
GitLab team members who apply the ~"Accepting Merge Requests" label to an issue GitLab team members who apply the ~"Accepting merge requests" label to an issue
should update the issue description with a responsible product manager, inviting should update the issue description with a responsible product manager, inviting
any potential community contributor to @-mention per above. any potential community contributor to @-mention per above.
[up-for-grabs]: https://gitlab.com/gitlab-org/gitlab-ce/issues?label_name=Accepting+Merge+Requests&scope=all&sort=weight_asc&state=opened [up-for-grabs]: https://gitlab.com/groups/gitlab-org/-/issues?state=opened&label_name[]=Accepting+merge+requests&assignee_id=0&sort=weight
[firt-timers]: https://gitlab.com/gitlab-org/gitlab-ce/issues?label_name%5B%5D=Accepting+Merge+Requests&scope=all&sort=upvotes_desc&state=opened&weight=1 [firt-timers]: https://gitlab.com/groups/gitlab-org/-/issues?state=opened&label_name[]=Accepting+merge+requests&assignee_id=0&sort=weight&weight=1
## Issue triaging ## Issue triaging
......
...@@ -2,10 +2,9 @@ ...@@ -2,10 +2,9 @@
We welcome merge requests with fixes and improvements to GitLab code, tests, We welcome merge requests with fixes and improvements to GitLab code, tests,
and/or documentation. The issues that are specifically suitable for and/or documentation. The issues that are specifically suitable for
community contributions are listed with the community contributions are listed with
[`Backlog (Accepting merge requests)` milestone in the CE issue tracker][accepting-mrs-ce] [the `Accepting merge requests` label](issue_workflow.md#label-for-community-contributors),
and [EE issue tracker][accepting-mrs-ee], but you are free to contribute to any other issue but you are free to contribute to any other issue you want.
you want.
Please note that if an issue is marked for the current milestone either before Please note that if an issue is marked for the current milestone either before
or while you are working on it, a team member may take over the merge request or while you are working on it, a team member may take over the merge request
...@@ -25,8 +24,6 @@ some potentially easy issues. ...@@ -25,8 +24,6 @@ some potentially easy issues.
To start with GitLab development download the [GitLab Development Kit][gdk] and To start with GitLab development download the [GitLab Development Kit][gdk] and
see the [Development section](../../README.md) for some guidelines. see the [Development section](../../README.md) for some guidelines.
[accepting-mrs-ce]: https://gitlab.com/gitlab-org/gitlab-ce/issues?milestone_title=Backlog%20&#40;Accepting%20merge%20requests&#41;
[accepting-mrs-ee]: https://gitlab.com/gitlab-org/gitlab-ee/issues?milestone_title=Backlog%20&#40;Accepting%20merge%20requests&#41;
[gitlab-mr-tracker]: https://gitlab.com/gitlab-org/gitlab-ce/merge_requests [gitlab-mr-tracker]: https://gitlab.com/gitlab-org/gitlab-ce/merge_requests
[gdk]: https://gitlab.com/gitlab-org/gitlab-development-kit [gdk]: https://gitlab.com/gitlab-org/gitlab-development-kit
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment