Repository¶

Structure¶

The qMp git repository is split in three branches:

1. Master
2. Testing
3. Other/Features

Master¶

This is the main branch and all changes committed here must be tested in Testing branch before.

However the small bugfixes can be directly applied here. These changes must be merged in the testing branch.

o---o---o---o---o master
                 \  
--o---o---o---o---o testing 

Testing¶

This is the branch for test new features and changes. The features must be already working features tested before in a specific branch by at least the developer. A feature can be committed here only when it is finished, but not in a middle state.

When the testing branch are deeply tested by more than one developer, than it can be merged in the master branch.

o---o---o---o---o master
     \         /  
--o---o---o---o testing 

Other: Features/Bugfixes¶

The rest of the branches are temporal branches.

If it is about a new feature the name of the branch must be the name of the feature (of some name which identifies it). These branches are considered non-functional, so a non-finished feature can be committed here. Once the feature is finish and tested by at least the developer, it should be merged to testing.

o---o---o---o---o master

      o---o---o issue#23-new-feature
     /         \
o---o---o---o---o testing 

A bugfix must be solved in a new branch. This branch must be based in a commit of the master branch. This branch can't be based in a commit of the testing branch because this branch can has new features, and these new features maybe can't be imported in the master branch. This new branch can be merged in testing.

o---o---o---o---o master
     \         /
      o---o---o issue#23-bugfix
               \
o---o---o---o---o testing 

How to use it¶

Good practices¶