Salta el contingut

GitHub Projects

Que és GitHub Projects?

GitHub Projects (Projects v2) és l'eina de gestió de projectes integrada a GitHub. És gratuïta per a tots els repositoris públics i per a comptes personals. Per a equips ASIX que ja usen GitHub per als repositoris de configuració (Ansible, Terraform, scripts), és la solució més integrada.

A diferència de Jira, GitHub Projects no imposa cap estructura predefinida: es configura de zero i s'adapta tant a Scrum com a Kanban o qualsevol altre flux.

Conceptes bàsics

Issues i Pull Requests com a items

A GitHub, el treball s'expressa com Issues (tasques, bugs, histories d'usuari). Quan es fa un canvi al codi o configuració, s'obre un Pull Request que referencia l'Issue corresponent. Ambdós es poden afegir directament al tauler del projecte.

Camps personalitzats

Projects v2 permet afegir camps personalitzats a cada item:

  • Estat (columna del tauler): Per fer, En progrés, En revisió, Fet.
  • Prioritat: Alta, Mitjana, Baixa.
  • Story Points / Estimació: número.
  • Sprint: iteració (nom o número).
  • Assignat a: membre de l'equip.
  • Etiquetes: components, tipus d'item.

Configurar un projecte Scrum a GitHub Projects

1. Crear el projecte

github.com → el vostre perfil o organització → Projects → New project → Board (per a tauler tipus Kanban/Scrum) o Table (per a una vista de backlog).

2. Configurar les columnes del tauler

Per a Scrum, les columnes recomanades:

Backlog  |  Sprint Backlog  |  En progrés  |  En revisió  |  Fet

Afegiu una columna per a "Bloquejat" si el vostre equip sovint té tasques pendents de tercers.

3. Crear Issues

Des del repositori: Issues → New issue. Useu plantilles per estandaritzar les histories d'usuari:

## Historia d'usuari
Com a [tipus d'usuari], vull [accio], per tal de [benefici].

## Criteris d'acceptacio
- [ ] Criteri 1
- [ ] Criteri 2
- [ ] Criteri 3

## Estimacio
Story Points: X

4. Vistes del projecte

Projects v2 permet múltiples vistes del mateix projecte:

  • Tauler (Board): vista Kanban per columnes. Ideal per al dia a dia del sprint.
  • Taula (Table): vista de llista amb tots els camps. Ideal per al backlog i l'estimació.
  • Roadmap: vista de Gantt per a la planificació d'Epics i Milestones.

5. Automatitzacions

GitHub Projects inclou automatitzacions bàsiques predefinides:

  • Quan un PR és obert → mou l'issue associat a "En progrés".
  • Quan un PR és tancat (merged) → mou l'issue a "Fet".
  • Quan un issue és tancat → mou-lo a "Fet".

Integrar Issues amb el codi

La integració entre Issues i codi és el gran avantatge de GitHub Projects respecte a Jira en entorns que ja usen GitHub.

Referenciar Issues als commits

git commit -m "Configura monitoring de disc - fixes #42"

Quan el commit arriba a la branca principal, l'issue #42 es tanca automàticament.

Crear branques des d'un Issue

A l'Issue, clic a Create a branch. GitHub crea una branca amb el nom 42-configura-monitoring-de-disc. Quan es fa merge del PR, l'Issue es tanca sol.

Milestones com a Sprints

Useu Milestones per representar els sprints:

  • Sprint 1 — 2026-01-13 al 2026-01-24
  • Sprint 2 — 2026-01-27 al 2026-02-07

Cada Milestone mostra el progrés (% d'Issues tancats) i la data de venciment, funcionant com un burndown simplificat.

Activitat AC-RA4-02

Configureu GitHub Projects per al vostre projecte de pràctiques:

  1. Creeu un repositori nou (o useu un existent) i activeu Projects.
  2. Configureu un tauler amb les columnes adequades al vostre flux.
  3. Creeu almenys 8 Issues usant la plantilla de historia d'usuari.
  4. Afegiu camps personalitzats: Prioritat, Story Points, Sprint.
  5. Creeu 2 Milestones (Sprint 1 i Sprint 2) i assigneu-hi issues.
  6. Configureu les automatitzacions per moure issues automàticament quan canvien d'estat.
  7. Feu un commit que tanqui un issue automàticament i verificeu que funciona.