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
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/)