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

  1. Accedeix al Repositori Original: Navega fins al repositori que vols forkar a GitHub.
  2. 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.
  3. Selecciona el Compte: Si tens múltiples comptes o organitzacions, selecciona on vols crear el fork.
  4. 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

  1. Fes Canvis al Teu Fork: Realitza els canvis necessaris al teu repositori forkat.
  2. Puja els Canvis: Puja els canvis al teu repositori forkat a GitHub.
  3. 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

  1. Fork del Repositori: Tria un repositori públic a GitHub i fes un fork.
  2. Clona el Fork: Clona el repositori forkat al teu ordinador.
  3. Crea una Nova Branca: Crea una nova branca per als teus canvis.
  4. Fes un Canvi: Realitza un canvi simple, com ara afegir un fitxer README.
  5. Comet i Puja els Canvis: Comet els canvis i puja'ls al teu repositori forkat.
  6. 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

Mòdul 3: Branques i Fusió

Mòdul 4: Treballant amb Repositoris Remots

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

Mòdul 8: Millors Pràctiques i Consells de Git

Mòdul 9: Resolució de Problemes i Depuració

Mòdul 10: Git en el Món Real

© Copyright 2024. Tots els drets reservats