2015-07-30 16:50:15 -04:00
|
|
|
# How to create a merge request
|
|
|
|
|
2016-10-11 05:29:16 -04:00
|
|
|
Merge requests are useful to integrate separate changes that you've made to a
|
|
|
|
project, on different branches. This is a brief guide on how to create a merge
|
|
|
|
request. For more information, check the
|
2017-10-21 13:52:17 -04:00
|
|
|
[merge requests documentation](../user/project/merge_requests/index.md).
|
2015-07-30 16:50:15 -04:00
|
|
|
|
2016-10-11 05:29:16 -04:00
|
|
|
---
|
2015-07-30 16:50:15 -04:00
|
|
|
|
2016-10-11 05:29:16 -04:00
|
|
|
1. Before you start, you should have already [created a branch](create-branch.md)
|
2019-03-26 06:01:52 -04:00
|
|
|
and [pushed your changes](start-using-git.md#send-changes-to-gitlabcom) to GitLab.
|
2017-10-21 13:52:17 -04:00
|
|
|
1. Go to the project where you'd like to merge your changes and click on the
|
|
|
|
**Merge requests** tab.
|
2016-10-11 05:29:16 -04:00
|
|
|
1. Click on **New merge request** on the right side of the screen.
|
2017-10-21 13:52:17 -04:00
|
|
|
1. From there on, you have the option to select the source branch and the target
|
|
|
|
branch you'd like to compare to. The default target project is the upstream
|
|
|
|
repository, but you can choose to compare across any of its forks.
|
2015-07-30 16:50:15 -04:00
|
|
|
|
2016-10-11 05:29:16 -04:00
|
|
|
![Select a branch](img/merge_request_select_branch.png)
|
2015-07-30 16:50:15 -04:00
|
|
|
|
2017-10-21 13:52:17 -04:00
|
|
|
1. When ready, click on the **Compare branches and continue** button.
|
2016-10-11 05:29:16 -04:00
|
|
|
1. At a minimum, add a title and a description to your merge request. Optionally,
|
|
|
|
select a user to review your merge request and to accept or close it. You may
|
|
|
|
also select a milestone and labels.
|
2015-07-30 16:50:15 -04:00
|
|
|
|
2016-10-11 05:29:16 -04:00
|
|
|
![New merge request page](img/merge_request_page.png)
|
2015-07-30 16:50:15 -04:00
|
|
|
|
2017-10-21 13:52:17 -04:00
|
|
|
1. When ready, click on the **Submit merge request** button.
|
|
|
|
|
|
|
|
Your merge request will be ready to be approved and merged.
|