EDUCATIC
/
digitaldemocratic
mirror of https://gitlab.com/digitaldemocratic/digitaldemocratic
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

WIP contfibuting translation

merge-requests/85/head
Aleix Quintana Alsius 2023-04-22 16:18:24 +00:00
parent fa765bbc66
commit 32e2db0cf2
1 changed files with 19 additions and 35 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

54
docs/contributing.md
View File

@ -4,60 +4,44 @@ DD is free software under AGPL3+ license, and contributions are welcome.
## Source code ## 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) [https://gitlab.com/DD-workspace/DD](https://gitlab.com/DD-workspace/DD)
## DD Architecture ## DD Architecture
Per molts canvis serà necessari que us familiaritzeu amb l'arquitectura del DD. Code modifications will require you to familiarize yourself with DD architecture.
El diagrama d'arquitectura del DD es troba al repositori en format
[editable][diagramedit], i hi podeu contribuir com amb qualsevol altre canvi.
![DD Workspace for education - Arquitectura](assets/diagram/dd_workspace_education.png) ![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 [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 In order to organize contributions, adaptive software development methodology(ASD) is used.
Desenvolupament Adaptatiu de Software
(o ASD per les seves sigles en anglès Adaptive Software Development).
Aquesta metodologia posa el focus en les dinàmiques d'equips auto-organitzats, 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.
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.
ASD ajuda a construir sistemes de software complexes, en el nostre cas un ASD helps build complex software systems, in our case a digital educational environment.
entorn educatiu digital.
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 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.
necessitats del projecte, dels usuaris, etc. (en forma de [Issues][issues], 2. **Collaboration**: In this phase we organize and work together, always taking care that working people must:
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:
- Criticar sense hostilitat - Criticize without hostility
- Assistir sense ressentiment - Attend without resentment
- Treballar el més fortament possible - Work as hard as possible
- Tenir o obtenir les habilitats necessàries - Behave or obtain the necessary skills
- Comunicar els problemes que eviten trobar una solució efectiva - Communicate the issues that prevent finding an effective solution
3. **Aprenentatge**: Tant si arribem al resultat desitjat com si no, aquest 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.
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.
Aplicant aquesta metodologia de manera iterativa anem millorant el projecte By applying this methodology in an iterative way, we improve the project incrementally.
incrementalment.
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://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/) - [https://www.geeksforgeeks.org/adaptive-software-development-asd/](https://www.geeksforgeeks.org/adaptive-software-development-asd/)