aboutsummaryrefslogtreecommitdiffhomepage
path: root/markup/pod/live-manual/media/text/ca/project_contributing.ssi
diff options
context:
space:
mode:
authorRalph Amissah <ralph.amissah@gmail.com>2021-11-27 21:54:49 -0500
committerRalph Amissah <ralph.amissah@gmail.com>2021-11-27 21:54:49 -0500
commit78b1b83be0cf04b4cba707751b7ad4d97787fe37 (patch)
tree0260daae62c3c0c055b7ec73b274fa82b31b344f /markup/pod/live-manual/media/text/ca/project_contributing.ssi
track document samples used
Diffstat (limited to 'markup/pod/live-manual/media/text/ca/project_contributing.ssi')
-rw-r--r--markup/pod/live-manual/media/text/ca/project_contributing.ssi119
1 files changed, 119 insertions, 0 deletions
diff --git a/markup/pod/live-manual/media/text/ca/project_contributing.ssi b/markup/pod/live-manual/media/text/ca/project_contributing.ssi
new file mode 100644
index 0000000..ecb3573
--- /dev/null
+++ b/markup/pod/live-manual/media/text/ca/project_contributing.ssi
@@ -0,0 +1,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