How to create a feature branch [editor]

Introduction

At some point you want to leave the current branch (often called 'Trunk') stable and you want to create new functionality in a new separate branch. As soon as this new functionality is tested and ok you want to merge it back to your current (stable) branch.

Steps

To achieve this you have create a new branch. To be able to do this make sure you registered all changes. If you have done that you should go to 'File' > 'Home'. Click on 'Version management'.

Select the correct repository on the bottom and the correct project on top of the left bar. In the ribbon some options appear. One of them are 'New branch'.

You can enter the following fields:

• Branch Type
• Name
• Functional name
• Description

Only 'Name' is required, so enter the name of the branch. At the top left the new branch is shown.

If you open the history of the newly created branch (File > History) you will not see anything that has to do with the newly created branch. This is due to the fact that there are still no changes in the newly created branch. As soon as new changes are registered, you will find an entry in the history log. This entry clearly shows that the change was made in this branch (in the Branch column) and you will also see another color in the branch graph (the first column).

Merge from Trunk to FeatureBranch

When there are new changes in the Trunk branch, it is very easy to merge them to the feature branch. This can be done by moving to the Trunk branch, do some changes, register them. Next you have to do a merge. This can be done as follows:

1. Go to Home
2. Click on Version management
3. Select the correct repository and the correct branch (Trunk)
4. Click on Distribute to branch
   
5. The From field is prefilled with the current branch (Trunk)
6. Select the To branch (FeatureBranch)
7. It will show the registered changes that can be selected in bold.
8. Select one of them
   
9. In the Details overview you see the elements that have been changed in this commit (which was done in the Trunk).
10. Now click on Merge.
11. The system performs some checks and present you an overview with:
    1. Impact report
    2. Conflicts (0)
    3. Merged revisions
12. As there are no conflicts you can click on Apply and Close.
13. Click on FeatureBranch at the left side and click on Open branch on the top.
14. Open the project.
15. Click on File > Pending changes.
16. Here you see the elements that have been changed.
17. In the middle of the screen at Merges you also see the register message which was added in Trunk.
18. Now you can also register these changes in this branch.

Discard changes

...

Step-by-step guide