Col·laborar-OCA.md

-Per col·laborar a l'OCA, cal seguir els següents passos:
+Per col·laborar a l'OCA, cal seguir els següents passos:
\ No newline at end of file
+
+* Disposar d'un compte *personal* al GitHub
+* Demanar pertànyer al grup `minorisa` de GitHub
+* Registrar-se en la comunitat de l'OCA
+* Fer un `fork` del projecte de l'OCA en el qual es vulgui col·laborar.
+* Fer modificacions en el projecte
+* Demanar un **Pull Request (PR)** per tal de fer un `merge` del codi a la branca oficial
+
+## Disposar d'un compte *personal* al GitHub
+
+Per poder col·laborar a l'OCA, cal disposar d'un compte *personal* al GitHub.
+
+Si no se'n disposa d'un, es crea al GitHub: només cal triar un nom d'usuari, una contrasenya i especificar una adreça de correu electrònic.
+
+A la resta d'aquest document, suposarem que l'usuari és `usrGH`. Per tant, existirà un espai a https://github.com/usrGH.
+
+## Demanar pertànyer al grup `minorisa` del Github
+
+Si encara no s'és membre del grup `minorisa`, caldrà demanar-ho a qualsevol dels seus administradors (Jaume Planas, Ramon Guiu, etc.) per tal d'afegir l'usuari `usrGH` com a membre del grup `minorisa`
+
+## Registrar-se en la comunitat de l'OCA
+
+Si es vol col·laborar a la comunitat de l'OCA, cal registrar-se en aquesta comunitat. Per fer-ho, cal visitar la pàgina [Contributor License Agreement](https://odoo-community.org/page/cla).
+
+El procés és el següent:
+
+* Baixar-se el PDF **Individual CLA**
+
+  Per omplir-lo correctament, només cal tenir en compte la part final del PDF, per exemple:
+
+  > You
+
+  > ________________________
+
+  > Name: Jaume Planas Jarque
+
+  > Address: ________________
+
+  > carrer, 08600 Berga, Spain
+
+* Signar-lo manualment. Potser caldrà imprimir-lo, signar-lo a ma i escanejar-lo.
+
+* Enviar-lo a cla@odoo-community.org.
+
+  El cos de l'email pot ser semblant a:
+
+  > Hi,
+
+  > Please find attached signed CLA for Github login: usrGH
+
+  > Please advise if any problem.
+
+  > Best regards,
+
+## Fer un `fork` del projecte
+
+Suposem que volem treballar en el mòdul `unmòdul` del projecte `l10n-spain` de l'OCA. Seguirem el següent procés:
+
+* Si a https://github.com/minorisa no existeix cap fork del projecte `l10n-spain' (hauria de ser `https://github.com/minorisa/l10n-spain`), crear-lo des de la interfície del GitHub.
+
+* Fer un `git clone` d'aquest projecte de `minorisa` en local.
+
+* En el git local, afegir un nou *remote*. A més a més de l'`origin` que apuntarà al repositori de `minorisa`, afegirem un *remote* que apunti al projecte de l'OCA. Per exemple:
+
+> git remote add oca https://github.com/OCA/l10n-spain.git
+
+* Actualitzarem el repositori local **des de l'OCA**:
+
+> git pull origin oca -b 11.0
+
+* Crearem la branca de treball, per exemple `11.0-mig-unmòdul` o la nomenclatura que demanin les directrius de l'OCA.
+
+* Treballarem en local, farem `commits` en local i farem `push` **al repositori de Minorisa**:
+
+> git push origin 11.0-mig-unmòdul
+
+  Fins que creguem que ja passa tots els tests de Travis i Runbot.
+
+## Demanar un **Pull Request (PR)**
+
+Un cop tinguem tot el treball a la branca de `minorisa`, des del repositori oficial de l'OCA demanarem un **PR**, de la nostra branca de `minorisa` a la nova branca de l'`OCA`.
+
+Aquesta operació activarà la integració continua a RunBot i Travis ens anirà dient si passa o no. En el cas de que no passi els tests, seguirem treballant a la nostra branca local, acceptarem les suggerències de la comunitat i els `commits` els pujarem a la branca de **Minorisa**:
+
+> git push origin 11.0-mig-unmòdul
+
+Cada vegada que fem un `push` es farà una integració continua i donarà un resultat positiu o negatiu. Quan sigui positiu, el responsable de l'OCA ja acceptarà el PR, farà un `merge` i ja tindrem la nostra col·laboració a la comunitat oficial.