Instruccions entrega
Passos per entregar tasques amb exemples de nomenclatura¶
1. Clonar i crear branca per la tasca¶
Cada nova tasca es treballa en una branca nova, derivada de la branca principal de desenvolupament (normalment develop o main).
Exemple nomenclatura branca:
feature/tasca1-investigacio-mercat
feature/tasca2-identificacio-necesitats
feature/tasca4-definicio-abast
2. Estructura de carpetes i fitxers al repositori¶
A dins del repositori, organitzar per blocs i tasques, noms clars representatius:
/bloc-1/
/tasca-1-1/
informe-analisi-mercat.pdf
/tasca-1-2/
informe-necesitats.pdf
evidencies-entrevistes.pdf
/tasca-1-4/
statement-of-work.pdf
3. Commit i empenta (push)¶
Fer commits clars i descriure el que s’ha afegit o modificat:
git add bloc-1/tasca-1-4/statement-of-work.pdf
git commit -m "Afegit document SOW per Tasca 1.4"
git push origin feature/tasca1-definicio-abast
4. Crear Pull Request (PR)¶
Després de fer push, es crea una Pull Request cap a la branca principal (develop o main), on s’explica breument què s’ha fet.
Exemple descripció PR:
Tasca 1.4: Definició de l’abast del projecte. Inclou Statement of Work amb requisits funcionals i no funcionals.
5. Revisió i integració¶
El professor o equip revisa el PR, fa comentaris si cal, i després integra (merge) la branca a la principal.
Recomanacions addicionals¶
- No treballar mai directament en la branca principal (
mainodevelop). - Fer branques per cada tasca o funcionalitat.
- Utilitzar missatges de commit clars i concisos.
- Descriure les PR de forma precisa.
- Mantenir la llegibilitat i coherència a l’organització del repositori.
- Si cal, utilitzar versions o tags per entregar versions finals.