Projecte

General

Perfil

Repository » Historial » Versió 14

Simó Albert i Beltran, 02-12-2012 15:02
New feature branches should preferably be based on the master branch.

1 1 Pau Escrich
h1. Repository
2
3
h2. Structure
4
5
The qMp git repository is split in three branches:
6
7
# Master
8
# Testing
9
# Other/Features
10
11
h3. Master
12
13
This is the main branch and all changes committed here must be tested in Testing branch before.
14
15 6 Simó Albert i Beltran
However the small bugfixes can be directly applied here. These changes must be merged in the testing branch.
16 1 Pau Escrich
17 10 Simó Albert i Beltran
<pre>
18
o---o---o---o---o master
19
                 \  
20
--o---o---o---o---o testing 
21
</pre>
22
23 1 Pau Escrich
h3. Testing
24
25 8 Simó Albert i Beltran
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.
26 1 Pau Escrich
27 11 Simó Albert i Beltran
When the testing branch are deeply tested by more than one developer, than it can be merged in the master branch.
28
29
<pre>
30
o---o---o---o---o master
31
     \         /  
32
--o---o---o---o testing 
33
</pre>
34
35
36 12 Simó Albert i Beltran
h3. Other: Features/Bugfixes
37 1 Pau Escrich
38 8 Simó Albert i Beltran
The rest of the branches are temporal branches.
39
40 14 Simó Albert i Beltran
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. This branch should preferably be based on a commit of master branch. Once the feature is finish and tested by at least the developer, it should be merged to testing.
41 1 Pau Escrich
42 9 Simó Albert i Beltran
<pre>
43
o---o---o---o---o master
44 14 Simó Albert i Beltran
     \
45 9 Simó Albert i Beltran
      o---o---o issue#23-new-feature
46 14 Simó Albert i Beltran
               \
47 9 Simó Albert i Beltran
o---o---o---o---o testing 
48
</pre>
49
50
51 13 Simó Albert i Beltran
A bugfix must be implemented 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.
52 7 Simó Albert i Beltran
53
<pre>
54
o---o---o---o---o master
55 1 Pau Escrich
     \         /
56 9 Simó Albert i Beltran
      o---o---o issue#23-bugfix
57 7 Simó Albert i Beltran
               \
58
o---o---o---o---o testing 
59
</pre>
60 1 Pau Escrich
61
h2. How to use it
62
63 2 Pau Escrich
64
h2. Good practices