Les revisions de codi són una part essencial del desenvolupament de programari col·laboratiu. Permeten que els equips millorin la qualitat del codi, detectin errors i comparteixin coneixements. En aquest tema, aprendrem com utilitzar Git per facilitar les revisions de codi.

Una revisió de codi és el procés de revisar el codi escrit per un altre desenvolupador per assegurar-se que compleix amb els estàndards de qualitat, és correcte i és fàcil de mantenir. Les revisions de codi poden ser formals o informals i poden implicar eines automatitzades o simplement la lectura del codi.

• Millora de la Qualitat del Codi: Identificació d'errors i millora de la qualitat general del codi.
• Compartició de Coneixements: Els desenvolupadors aprenen els uns dels altres.
• Estàndards de Codi: Assegura que el codi compleix amb els estàndards de l'equip.
• Col·laboració: Fomenta la col·laboració i la comunicació dins de l'equip.

GitHub és una de les plataformes més populars per a la col·laboració en codi i ofereix una funcionalitat robusta per a les revisions de codi a través de les "Pull Requests".

Crear una Pull Request

1. Crea una branca nova:

   git checkout -b feature/nova-funcionalitat
   

2. Fes canvis i commiteja'ls:

   git add .
   git commit -m "Afegeix nova funcionalitat"
   

3. Empeny la branca al repositori remot:

   git push origin feature/nova-funcionalitat
   

4. Crea una Pull Request a GitHub:

   • Ves al repositori a GitHub.
   • Fes clic a "Compare & pull request".
   • Afegeix una descripció i assigna revisors.

Revisar una Pull Request

1. Accedeix a la Pull Request:

   • Ves a la pestanya "Pull requests" del repositori.
   • Selecciona la Pull Request que vols revisar.

2. Revisa els canvis:

   • Utilitza la vista de "Files changed" per veure els canvis línia per línia.
   • Afegeix comentaris a línies específiques si cal.

3. Aprova o sol·licita canvis:

   • Si els canvis són acceptables, fes clic a "Approve".
   • Si calen canvis, fes clic a "Request changes" i proporciona feedback.

GitLab ofereix una funcionalitat similar a les Pull Requests de GitHub, anomenada "Merge Requests".

Crear una Merge Request

1. Crea una branca nova:

   git checkout -b feature/nova-funcionalitat
   

2. Fes canvis i commiteja'ls:

   git add .
   git commit -m "Afegeix nova funcionalitat"
   

3. Empeny la branca al repositori remot:

   git push origin feature/nova-funcionalitat
   

4. Crea una Merge Request a GitLab:

   • Ves al repositori a GitLab.
   • Fes clic a "Merge Requests" i després a "New merge request".
   • Selecciona la branca i crea la Merge Request.

Revisar una Merge Request

1. Accedeix a la Merge Request:

   • Ves a la pestanya "Merge Requests" del repositori.
   • Selecciona la Merge Request que vols revisar.

2. Revisa els canvis:

   • Utilitza la vista de "Changes" per veure els canvis línia per línia.
   • Afegeix comentaris a línies específiques si cal.

3. Aprova o sol·licita canvis:

   • Si els canvis són acceptables, fes clic a "Approve".
   • Si calen canvis, fes clic a "Request changes" i proporciona feedback.

• Sigues Respectuós: Proporciona feedback constructiu i respectuós.
• Sigues Clar: Sigues específic en els teus comentaris.
• Revisa Regularment: Fes revisions de codi de manera regular per evitar acumulacions.
• Utilitza Eines Automatitzades: Utilitza eines com linters i analitzadors de codi estàtic per detectar problemes automàticament.

1. Crea una nova branca anomenada feature/exercici:

   git checkout -b feature/exercici
   

2. Afegeix un fitxer nou anomenat exercici.txt amb el contingut "Hola, món!":

   echo "Hola, món!" > exercici.txt
   

3. Commet els canvis:

   git add exercici.txt
   git commit -m "Afegeix exercici.txt"
   

4. Empeny la branca al repositori remot:

   git push origin feature/exercici
   

5. Crea una Pull Request a GitHub i assigna un company per revisar-la.

6. Revisa la Pull Request del teu company, proporciona feedback i aprova-la o sol·licita canvis.

Aquest exercici és pràctic i no té una solució única. L'objectiu és familiaritzar-se amb el procés de creació i revisió de Pull Requests.

Les revisions de codi són una eina poderosa per millorar la qualitat del codi i fomentar la col·laboració dins dels equips de desenvolupament. Utilitzant Git i plataformes com GitHub o GitLab, podem integrar les revisions de codi en el nostre flux de treball de manera eficient. Practicar aquestes tècniques ens ajudarà a convertir-nos en desenvolupadors més efectius i col·laboratius.