|
|
Forks i Pull RequestsAutor: Joan Puigcerver Ibáñez Correu electrònic: j.puigcerveribanez@edu.gva.es Llicència: CC BY-NC-SA 4.0 (Reconeixement - NoComercial - CompartirIgual) 🅭 
Forks i Pull Requests¶Dins de les eines de col·laboració que ofereixen els serveis d'allotjament de repositoris en línia com GitHub o GitLab, hi ha dues funcionalitats clau:
Aquestes dues funcionalitats són essencials per a la col·laboració en projectes de desenvolupament de programari de manera distribuïda i col·laborativa, sobretot en projectes de codi obert. Forks¶Una bifurcació o fork és una còpia d'un repositori que pertany a un usuari o organització com a propi. En el teu fork pots realitzar qualsevol canvi com:
Un fork sempre està enllaçat amb el repositori original, de manera que es si es realitzen canvis en el repositori original, pots decidir incorporar-lo al teu fork.
Figura 1. Estructura de treball amb Forks i Pull Requests Exemple de bifurcació de Material for MkDocs
Figura 2.Repositori Material for MkDocs principal Per a poder realitzar contribucions, s'ha creat un fork del repositori original.
Figura 3.Repositori Material for MkDocs bifurcat Creació d'un Fork¶Per crear un fork d'un repositori, cal accedir a la pàgina del repositori i fer clic al botó Fork que apareix a la part superior dreta. Creació d'un fork de Material for MkDocsVegem el menú de creació d'un fork en el repositori Material for MkDocs.
Figura 4. Creació d'un fork en el repositori Material for MkDocs Pull Requests¶Una Sol·licitud de Incorporació o Pull Request (PR) és una sol·licitud per a incorporar canvis a un repositori. Els PR poden ser utilitzats per a:
Aquesta funcionalitat es essencial per a la col·laboració en projectes, especialment els de codi obert. A més, aquesta funcionalitat pot ser implementada dins d'una estratègia de ramificació. A un PR es pot afegir informació com:
A més, es pot consultar:
Les PR poden estar en quatre estats diferents:
Exemple de Pull Request a Material for MkDocsEn el repositori Material for MkDocs existeixen múltiples PR on s'han realitzat canvis per a millorar el tema o actualitzar la documentació.
Figura 5. Exemple de Pull Request en el repositori Material for MkDocs Creació d'un Pull Request¶Per crear un PR, cal accedir al teu fork o branca i fer clic al botó Pull Request. En el procés de creació d'un PR, es mostrarà una pantalla on es compararan els canvis realitzats amb la branca de destí i es podrà afegir informació addicional com el títol i la descripció. Creació d'un Pull RequestA la branca
Figura 6. Creació d'un Pull Request En la pantalla de creació d'un PR es poden veure els canvis realitzats en la branca
Figura 7. Comparació de canvis en un Pull Request Una vegada creat la PR, es pot sol·licitar la revisió dels canvis a altres usuaris i realitzar els canvis necessaris fins a la seva acceptació. Incorporació de la Pull Request¶Quan un PR és acceptat, els canvis es fusionen amb la branca de destí i es tanca la PR. La fusió del PR pot ser de diferents tipus:
Figura 8. Tipus de fusió d'una Pull Request Configuració de les Pull Requests¶El repositori pot ser configurat per habilitar els diferents tipus de fusió, entre altres configuracions a l'apartat Settings
Figura 9. Configuració de les opcions de les Pull Requests Flux de treball¶Amb aquestes dues funcionalitats, es pot establir un flux de treball per a la col·laboració en projectes de desenvolupament de programari. Aquest flux de treball pot ser el següent:
Protecció de branques¶Per a evitar canvis no desitjats en les branques principals
i evitar problemes deguts a una mala aplicació de les Estratègies de ramificació,
les branques importants Per configurar les regles de protecció de branques, cal accedir a la configuració del repositori Settings i buscar l'apartat Rules.
Figura 10. Protecció de branques Aquestes regles permeten definir les condicions per modificar la branca especificada, com ara:
|
