WIP contributing translate

docs/contributing.md

@@ -48,64 +48,47 @@ Some free online resources to familiarize yourself with ASD are:
 - [https://yewtu.be/watch?v=HXJWwxL2N5A](https://yewtu.be/watch?v=HXJWwxL2N5A)
 - [https://files.ifi.uzh.ch/rerg/amadeus/teaching/seminars/seminar_ws0304/06_Eberle_ASD_Folien.pdf](https://files.ifi.uzh.ch/rerg/amadeus/teaching/seminars/seminar_ws0304/06_Eberle_ASD_Folien.pdf)
 
-### En la pràctica
+### In practice
 
-- Has detectat un problema? Ajuda'ns reportant un [problema/issue][issues].
+- Do you find any issue? Help us reporting the [issue][issues].
-- Vols afegir un parche? Et pot ser útil l'apartat dels controls de qualitat
+- Do you want to add a patch? You'll find useful information in section quality control below. Depending on how complex are your changes:
-  tot seguit. En funció de la complexitat dels teus canvis:
 
-    - Si en són senzills, obre directament una [Merge Request][mr]
+    - Simple changes: Open a [Merge Request][mr]
-      explicant el que vols afegir i per què.
+      explaining what are you adding and why.
-      D'aquesta manera iniciarà el procés de **revisió/review**.
+      Doing so a **review** process will be started.
-    - Si en són més complicats, potser posa't en contacte abans perquè puguem
+    - Complex changes: contact us before to decide if your solution is the optimal one for the project.
-      avaluar si la teva solució és la que més s'adjusta al projecte.
+      A good way of doing so is opening an [issue][issues] explaining what are you trying to to do, also why and how.
-      Una bona manera de fer-ho és obrint una [issue][issues] explicant el que
-      vols fer, per què i com.
 
-- Col·labores habitualment amb el DD? Ajuda amb les revisions de codi de les
+- Do you often collaborate with DD? Help with the pending [Merge Request][mr] reviews, keeping in mind the quality control.
-  [Merge Request][mr] pendents, tenint en compte els controls de qualitat.
 
 [issues]: https://gitlab.com/DD-workspace/DD/-/issues
 [mr]: https://gitlab.com/DD-workspace/DD/-/merge_requests
 
-## Controls de qualitat
+## Quality controls
 
 ### Continuous Integration
 
-Per simplificar la feina de revisió de codi i assegurar una certa qualitat del
+To simplify the review work and to ensure certain quality of what is integrated in repository: 
-que entra al repositori:
 
-- Ningú pot fer `push` a la branca principal (`main`) directament.
+- Nobody can direct `push` to `main` branch (`main`).
-  Sempre és necessari passar pel procés de [Merge Request][mr] i review.
+  Always is necessary to follow the [Merge Request][mr] review proces.
-- Disposem d'una instància de [buildbot][buildbot] com a Continuous Integration
+- ** TO BE REVIEWED ( branch based events?? )** There is a [buildbot][buildbot] instance (in `ci.dd-work.space`, login via GitLab) as a Continuous Integration that reacts to `push` events in `main` branch and to [Merge Request][mr] events in any other branch.
-  (a `ci.dd-work.space`, login amb GitLab) que reacciona a esdeveniments de
+    - When the event is a [Merge Request][mr], only static checks are executed, so no complete tests are launched.
-  tipus `push` al repositori principal, i de tipus [Merge Request][mr] des de
+      This is to prevent crypto mining CI/CD abuse.
-  qualsevol repositori.
+      These checks are the same as:
-    - Quan es tracta d'un [Merge Request][mr], només s'executen comprovacions
+      [ShellCheck][sc] for shell scripts, [mkdocs][mkdocs] to check that the documentation is generated as it should, soon we'll add linters and standard python checks.
-      de estàtiques, que no executen el codi del repositori.
+    - When the event is a `push` to `main`,
-      Això és per evitar abús de tipus mineria de criptomonedes i demés.
+      additionally to the [Merge Request][mr] tests, it will start the installation process from the scratch in a virtual machine.
-      Aquestes comprovacions ara mateix són:
+      This helps in detecting problems and makes sure that DD can be correctly.
-      [ShellCheck][sc] per scripts de shell, [mkdocs][mkdocs] per comprovar
+- Members of group `DD-workspace` in Gitlab have administration permissions in Buildbot  instance, this allow them to start or cancel build tasks manually if it is required.
-      que la documentació es genera correctament, i aviat hi afegirem linters i
-      comprovadors estàndard de Python.
-    - Quan es tracta d'un esdeveniment `push` al repositori principal,
-      addicionalment a les comprovacions anteriors, es comença el procés
-      d'instal·lació des de zero en una màquina virtual.
-      Això ajuda a detectar quan s'introdueixen problemes i a assegurar que el
-      DD es pot instal·lar correctament.
-- Els membres del grup `DD-workspace` a GitLab tenen permisos d'administració a
-  la instància de Buildbot, això els permet iniciar builds manualment o
-  cancel·lar tasques si és necessari.
 
 ### Checklist
 
-Abans d'aprovar una Merge Request, hem de fer les següents comprovacions als
+Before testing a Merge Request, we need to do these tests on the changes introduced:
-canvis que es volen introduir:
 
-- [ ] Passen les comprovacions a la CI
+- [ ] CI Tests passing.
-- [ ] Les modificacions introduïdes són necessàries, solucionen un problema
+- [ ] The changes are needed, and solves a real problem. Also the changeset improves the maintenance of the project.
-      real, o milloren la mantenibilitat del projecte
+- [ ] ConsiderateEs consideren i debaten les implicacions de **seguretat**
-- [ ] Es consideren i debaten les implicacions de **seguretat**
 - [ ] Es consideren i debaten les implicacions de **mantenibilitat**
 - [ ] Es revisen possibles regressions de funcionalitat
 - [ ] No s'utilitzen dades reals en les proves