gitlab-org--gitlab-foss/doc/topics/git/feature_branch_development.md

stage	group	info	type
Create	Source Code	To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#designated-technical-writers	how-tos

Develop on a feature branch

GitLab values encourage the use of Minimal Viable Change (MVC). However, viable changes are not always small. In such cases, it can help to set up a dedicated feature branch. People can contribute MRs to that feature branch, without affecting the functionality of the default (usually master) branch.

Once work on the development branch is complete, then the feature branch can be finally merged into the default branch.

GitLab frequently implements this process whenever there is an MVC that requires multiple MRs.

Use case: GitLab's release posts

This section describes the use case with GitLab release posts. Dozens of GitLab team members contribute to each monthly release post. In such cases, it may be more efficient to submit an MR on the release post feature branch instead of master.

In this case, the feature branch would be release-X-Y. Assuming the release-X-Y branch already exists, you can set up an MR against that branch, with the following steps:

1. Create a new branch (test-branch) against the feature branch (release-X-Y):

   git checkout -b test-branch release-X-Y
   

   You should now be on a branch named test-branch.

2. Make desired changes on the test-branch.

3. Add your changes, commit, and push to the test-branch:

   git add .
   

4. Commit your changes:

   git commit -m "Some good reason"
   

5. Push your changes to the repository:

   git push --set-upstream origin test-branch
   

6. Navigate to the URL for your repository. In this case, the repository is www-gitlab-com, available at https://gitlab.com/gitlab-com/www-gitlab-com.

   If needed, sign in to GitLab. You should then see an option to Create merge request:

   

7. After you click Create merge request, you'll see an option to Change branches. Select that option.

8. In the New Merge Request screen, you can now select the Source and Target branches. In the screenshot shown, we have selected test-branch as the source, and release-13-0 as the target.

   

9. Once you've selected the Source and Target branches, click Compare branches and continue. You should see an entry similar to:

   New Merge Request
   
   From test-branch into release-13-0
   

   An entry like this confirms that your MR will not merge into master.

10. Make any additional changes in the New Merge Request screen, and click Submit merge request.

11. In the new merge request, look for Request to merge. You'll see an entry similar to:

    Request to merge test-branch into release-13-0
    

    That confirms you've set up the MR to merge into the specified branch, not master.

12. Proceed with the change as you would with any other MR.

13. When your MR is approved, and an appropriate user merges that MR, you can rest assured that your work is incorporated directly into the feature branch. When the feature branch is ready, it can then be merged into master.