Introducció
En aquest tema, aprendrem sobre dues eines fonamentals per a la col·laboració en projectes de codi obert: el forking i els pull requests. Aquestes eines permeten als desenvolupadors treballar en còpies independents d'un projecte i proposar canvis per a la seva integració en el projecte original.
Què és el Forking?
El forking és el procés de crear una còpia d'un repositori existent sota el teu compte d'usuari. Aquesta còpia és completament independent del repositori original, el que et permet fer canvis sense afectar el projecte original.
Passos per fer un Fork
- Accedeix al Repositori Original: Navega fins al repositori que vols forkar a GitHub.
- Clica el Botó de Fork: A la part superior dreta de la pàgina del repositori, trobaràs un botó que diu "Fork". Clica'l.
- Selecciona el Compte: Si tens múltiples comptes o organitzacions, selecciona on vols crear el fork.
- Espera la Creació del Fork: GitHub crearà una còpia del repositori sota el teu compte.
Exemple Pràctic
# Clona el repositori forkat al teu ordinador git clone https://github.com/el-teu-usuari/nom-del-repositori.git # Canvia al directori del repositori cd nom-del-repositori
Què és un Pull Request?
Un pull request (PR) és una sol·licitud per fusionar canvis des del teu repositori forkat al repositori original. Els pull requests són una manera estructurada de proposar canvis i permeten als mantenidors del projecte revisar i discutir els canvis abans de fusionar-los.
Passos per Crear un Pull Request
- Fes Canvis al Teu Fork: Realitza els canvis necessaris al teu repositori forkat.
- Puja els Canvis: Puja els canvis al teu repositori forkat a GitHub.
- Crea el Pull Request:
- Navega fins al teu repositori forkat a GitHub.
- Clica el botó "New pull request".
- Selecciona la branca del teu fork i la branca del repositori original on vols fusionar els canvis.
- Afegeix una descripció detallada dels canvis i clica "Create pull request".
Exemple Pràctic
# Crea una nova branca per als teus canvis git checkout -b nova-branca # Fes els canvis necessaris # (edita fitxers, afegeix nous fitxers, etc.) # Afegeix els canvis a l'índex git add . # Comet els canvis git commit -m "Descripció dels canvis" # Puja la nova branca al teu repositori forkat git push origin nova-branca
Exercici Pràctic
Objectiu
Crea un fork d'un repositori, fes un canvi i crea un pull request per proposar el canvi al repositori original.
Passos
- Fork del Repositori: Tria un repositori públic a GitHub i fes un fork.
- Clona el Fork: Clona el repositori forkat al teu ordinador.
- Crea una Nova Branca: Crea una nova branca per als teus canvis.
- Fes un Canvi: Realitza un canvi simple, com ara afegir un fitxer README.
- Comet i Puja els Canvis: Comet els canvis i puja'ls al teu repositori forkat.
- Crea un Pull Request: Crea un pull request per proposar els teus canvis al repositori original.
Solució
# 1. Fork del Repositori # (Fes un fork del repositori a GitHub) # 2. Clona el Fork git clone https://github.com/el-teu-usuari/nom-del-repositori.git cd nom-del-repositori # 3. Crea una Nova Branca git checkout -b afegir-readme # 4. Fes un Canvi echo "# Aquest és un fitxer README" > README.md # 5. Comet i Puja els Canvis git add README.md git commit -m "Afegeix un fitxer README" git push origin afegir-readme # 6. Crea un Pull Request # (Navega fins al teu repositori forkat a GitHub i crea un pull request)
Errors Comuns i Consells
-
No Actualitzar el Fork: Abans de començar a treballar en un canvi, assegura't que el teu fork està actualitzat amb el repositori original.
# Afegeix el repositori original com a remot git remote add upstream https://github.com/original-usuari/nom-del-repositori.git # Actualitza el teu fork git fetch upstream git merge upstream/main
-
Missatges de Commit Poc Descriptius: Escriu missatges de commit clars i descriptius per facilitar la revisió dels canvis.
Conclusió
El forking i els pull requests són eines essencials per a la col·laboració en projectes de codi obert. El forking et permet treballar de manera independent, mentre que els pull requests faciliten la revisió i integració dels teus canvis en el projecte original. Practicar aquestes tècniques t'ajudarà a col·laborar de manera més efectiva en projectes de codi obert i a millorar les teves habilitats de desenvolupament col·laboratiu.
Dominar Git: De Principiant a Avançat
Mòdul 1: Introducció a Git
Mòdul 2: Operacions Bàsiques de Git
- Creant un Repositori
- Clonant un Repositori
- Flux de Treball Bàsic de Git
- Preparant i Cometent Canvis
- Veient l'Historial de Commits
Mòdul 3: Branques i Fusió
- Entenent les Branques
- Creant i Canviant de Branques
- Fusionant Branques
- Resolent Conflictes de Fusió
- Gestió de Branques
Mòdul 4: Treballant amb Repositoris Remots
- Entenent els Repositoris Remots
- Afegint un Repositori Remot
- Recuperant i Traient Canvis
- Empenyent Canvis
- Seguint Branques
Mòdul 5: Operacions Avançades de Git
Mòdul 6: Eines i Tècniques de Git
Mòdul 7: Estratègies de Col·laboració i Flux de Treball
- Forking i Pull Requests
- Revisions de Codi amb Git
- Flux de Treball Git Flow
- GitHub Flow
- Integració Contínua amb Git
Mòdul 8: Millors Pràctiques i Consells de Git
- Escrivint Bons Missatges de Commit
- Mantenint un Historial Netejat
- Ignorant Fitxers amb .gitignore
- Millors Pràctiques de Seguretat
- Consells de Rendiment
Mòdul 9: Resolució de Problemes i Depuració
- Problemes Comuns de Git
- Desfent Canvis
- Recuperant Commits Perduts
- Tractant amb Repositoris Corruptes
- Tècniques Avançades de Depuració