From 32e2db0cf2ac71b0f36be70aca188c4f4a1a864d Mon Sep 17 00:00:00 2001 From: Aleix Quintana Alsius Date: Sat, 22 Apr 2023 16:18:24 +0000 Subject: [PATCH] WIP contfibuting translation --- docs/contributing.md | 54 ++++++++++++++++---------------------------- 1 file changed, 19 insertions(+), 35 deletions(-) diff --git a/docs/contributing.md b/docs/contributing.md index dbdee73..1058fef 100644 --- a/docs/contributing.md +++ b/docs/contributing.md @@ -4,60 +4,44 @@ DD is free software under AGPL3+ license, and contributions are welcome. ## Source code -The source code repository and techincal documentation are in: +The source code repository and techincal documentation is available at: [https://gitlab.com/DD-workspace/DD](https://gitlab.com/DD-workspace/DD) ## DD Architecture -Per molts canvis serà necessari que us familiaritzeu amb l'arquitectura del DD. - -El diagrama d'arquitectura del DD es troba al repositori en format -[editable][diagramedit], i hi podeu contribuir com amb qualsevol altre canvi. +Code modifications will require you to familiarize yourself with DD architecture. ![DD Workspace for education - Arquitectura](assets/diagram/dd_workspace_education.png) +**Note** This DD architecture diagram can be found in code respository in [editable][diagramedit] format. Like the rest of the whole code, you can suggest modifications + [diagramedit]: https://gitlab.com/DD-workspace/DD/-/tree/main/docs/assets/diagram -## Metodología: Desenvolupament Adaptatiu de Software (ASD) +## Methodology: Adaptive software development(ASD) -Per tal d'organitzar-nos fem servir la metodologia de -Desenvolupament Adaptatiu de Software -(o ASD per les seves sigles en anglès Adaptive Software Development). +In order to organize contributions, adaptive software development methodology(ASD) is used. -Aquesta metodologia posa el focus en les dinàmiques d'equips auto-organitzats, -la col·laboració interpersonal i l'aprenentatge individual i dels equips -de manera que ens permet integrar fàcilment la naturalesa *Open Source* -del **DD** amb els cicles de feedback o d'actualització a les escoles que fan -part del projecte Pilot i les necessitats tècniques del projecte. +This methodology focuses on self-organized team dynamics, interpersonal collaboration, and individual and team learning in a way that allows integrate the *Open Source* nature of **DD** with feedback or update cycles in the schools that are part of the pilot project and the technical needs of the project. -ASD ajuda a construir sistemes de software complexes, en el nostre cas un -entorn educatiu digital. +ASD helps build complex software systems, in our case a digital educational environment. -S'organitza en cicles iteratius de 3 fases: +It is organized in iterative cycles of three phases : -1. **Especulació**: En aquesta fase planegem tenint en compte les limitacions i - necessitats del projecte, dels usuaris, etc. (en forma de [Issues][issues], - feedback o incidències) per tal de definir els cicles que volem. -2. **Col·laboració**: En aquesta fase ens organitzem i treballem conjuntament, - sempre tenint en compte que les persones que treballen juntes han de: +1. **Speculation**: In this phase a plan is made taking into account limitations and needs of the project, users, etc. writing issues, feedback or failures, in order to define the cycles. +2. **Collaboration**: In this phase we organize and work together, always taking care that working people must: - - Criticar sense hostilitat - - Assistir sense ressentiment - - Treballar el més fortament possible - - Tenir o obtenir les habilitats necessàries - - Comunicar els problemes que eviten trobar una solució efectiva + - Criticize without hostility + - Attend without resentment + - Work as hard as possible + - Behave or obtain the necessary skills + - Communicate the issues that prevent finding an effective solution -3. **Aprenentatge**: Tant si arribem al resultat desitjat com si no, aquest - procés haurà incrementat l'enteniment del projecte i les tecnologies - associades de totes les persones que hi participen. - En aquest procés una part crucial són les [Merge Request][mr] i les revisions - (**Reviews**) associades, així com la comunicació de l'equip que hi treballa. +3. **Learning**: Whether a desired result is reached or not, this process will help everyone involved, as it will increase the understanding of the project and its associated technologies. While working together [Merge Request][mr] and their associated reviews, as well as the communication between team working on and reporters are a crucial part. -Aplicant aquesta metodologia de manera iterativa anem millorant el projecte -incrementalment. +By applying this methodology in an iterative way, we improve the project incrementally. -Alguns recursos online gratuïts per familiaritzar-s'hi són: +Some free online resources to familiarize yourself with ASD are: - [https://users.exa.unicen.edu.ar/catedras/agilem/cap23asd.pdf](https://users.exa.unicen.edu.ar/catedras/agilem/cap23asd.pdf) - [https://www.geeksforgeeks.org/adaptive-software-development-asd/](https://www.geeksforgeeks.org/adaptive-software-development-asd/)