1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
|
:B~ Contribuir al projecte
1~contributing-to-project Contribuir al projecte
Quan s'envia una contribució, s'ha d'identificar clarament el titular dels
drets d'autor i incloure la declaració de concessió de llicències
aplicables. Recordar que per a ser acceptada, la contribució ha de tenir una
llicencia igual que la resta del document, a saber, la versió de la GPL 3 o
superior.
Les contribucions al projecte, com ara traduccions i pegats, són molt
benvingudes. Qualsevol persona pot fer un lliurament directe al
repositori. No obstant això, demanem que s'enviïn els canvis grans a la
llista de correu per a parlar-ne en primer lloc. Veure la secció
{Contacte}#contact per a més informació.
El ${project} utilitza Git com a sistema de control de versions i gestió de
codi font. Com s'explica en {Repositoris Git}#git-repositories hi ha dues
branques principals de desenvolupament: *{debian}* i *{debian-next}*. Tothom
pot fer lliuraments a les branques debian-next dels repositoris live-boot,
live-build, live-config, live-images, live-manual i live-tools.
No obstant això, hi ha certes restriccions. El servidor rebutja:
_* Push que no són fast-forward.
_* Commits merge.
_* Afegir o eliminar etiquetes o branques.
Tot i que tots els lliuraments poden ser revisats, demanem que s'utilitzi el
sentit comú i es facin bons lliuraments amb bons missatges.
_* Escriure missatges de lliurament que consisteixen en oracions completes i
significatives en anglès, començant amb una lletra majúscula i acabant amb
un punt. En general, aquests començaran amb la forma
'Fixing/Adding/Removing/Correcting/Translating/...'.
_* Escriure bons missatges de lliurament. La primera línia ha de ser un
resum exacte dels continguts del lliurament, que s'inclourà en la llista de
canvis. Si es necessita fer algunes explicacions més, escriure a sota
deixant una línia en blanc després de la primera línea i després una altra
línia en blanc després de cada paràgraf. Les línies dels paràgrafs no han de
superar els 80 caràcters de longitud.
_* Fer lliuraments de manera atòmica, és a dir, no barrejar coses no
relacionades en el mateix lliurament. Fer un lliurament diferent per a cada
canvi que es faci.
2~ Fer canvis
Per tal de fer un push als repositoris, s'ha de seguir el següent
procediment. Aquí s'utilitza live-manual com a exemple, per tant, cal
substituir-lo pel nom del repositori amb que es desitja treballar. Per a
obtenir informació detallada sobre com editar live-manual veure {Contribuir
a aquest document}#how-to-contribute.
_* Obtenir la clau pública:
code{
$ mkdir -p ~/.ssh/keys
$ wget http://live-systems.org/other/keys/git@live-systems.org -O ~/.ssh/keys/git@live-systems.org
$ wget http://live-systems.org/other/keys/git@live-systems.org.pub -O ~/.ssh/keys/git@live-systems.org.pub
$ chmod 0600 ~/.ssh/keys/git@live-systems.org*
}code
_* Afegir la següent secció a la configuració del vostre openssh-client:
code{
$ cat >> ~/.ssh/config << EOF
Host live-systems.org
Hostname live-systems.org
User git
IdentitiesOnly yes
IdentityFile ~/.ssh/keys/git@live-systems.org
EOF
}code
_* Fer una còpia del manual a través de ssh:
code{
$ git clone git@live-systems.org:/live-manual.git
$ cd live-manual && git checkout debian-next
}code
_* Assegurar-se de tenir el autor i el correu electrònic configurats al Git:
code{
$ git config user.name "John Doe"
$ git config user.email john@example.org
}code
*{Important:}* Tenir en compte que s'han d'enviar els canvis a la branca *{debian-next}*.
_* Fer els canvis. En aquest exemple s'hauria d'escriure primer una nova
secció sobre aplicar pegats i després preparar-se per a afegir els fitxers i
escriure el missatge de la següent manera:
code{
$ git commit -a -m "Adding a section on applying patches."
}code
_* Fer un push al servidor:
code{
$ git push
}code
|
