Salta el contingut

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 (main o develop).
  • 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.