GitHub què és i com utilitzar-lo

GitHub és un programari molt utilitzat pels equips de desenvolupament de programari per al control de versions de desenvolupament.

És útil quan més d'una persona està treballant en un projecte.

Per exemple, suposem que un equip de desenvolupadors de programari vol crear un lloc web i tots necessiten actualitzar el codi simultàniament mentre treballen en el projecte. En aquest cas, Github ajuda a crear un dipòsit centralitzat on tothom pot carregar, editar i gestionar fitxers de codi de programa.

Abans de començar a utilitzar GitHub, heu de crear un compte GitHub.

Dipòsit

Normalment s'utilitza un repositori per organitzar un projecte de programari d'aplicació. Els repositoris poden contenir carpetes i fitxers, imatges, vídeos, fulls de càlcul i conjunts de dades: tot el que necessita el vostre projecte. Sovint, els dipòsits inclouen un fitxer README, un fitxer amb informació sobre el vostre projecte.

Els fitxers README s'escriuen en llenguatge Markdown en text sense format. Podeu consultar aquesta pàgina web com a referència ràpida del llenguatge Markdown. GitHub us permet afegir un fitxer README al mateix temps que creeu el vostre nou dipòsit. GitHub també ofereix altres opcions habituals, com ara un fitxer de llicència, però no cal que en seleccioneu cap inicialment.

Per crear un repositori nou, a la part superior dreta seleccioneu al menú New repository. Continueu amb els passos següents:

1. A l'extrem superior dret de qualsevol pàgina, utilitzeu el menú desplegable i seleccioneu New repository.

1. Al quadre Nom del repositori, introduïu first-repository.
2. Al quadre Descripció, escriviu una breu descripció.
3. Seleccioneu Afegeix un fitxer README.
4. Seleccioneu si el vostre repositori serà públic o privat.
5. Clic Create repository.

Creació d'una branca

La creació d'una branca us permet tenir diverses versions d'un repositori alhora.

Per defectedefinita, el repositori first-repository té una branca anomenada main que es considera la branca definitiva. Podeu crear branques addicionals per principal al repositori first-repository. Podeu utilitzar branques per tenir diferents versions d'un projecte alhora. Això és útil quan voleu afegir noves funcionalitats a un projecte sense canviar el codi font principal. El treball fet en diferents branques no apareixerà a la branca mestra fins que la fusioneu. Podeu utilitzar les branques per experimentar i fer canvis abans de comprometre'ls a principal.

Quan creeu una branca a partir de la branca principal, esteu fent una còpia, o una instantània, de la branca principal tal com estava en aquell moment. Si algú més va fer canvis a la branca mestra mentre esteu treballant a la vostra branca, podeu enviar aquestes actualitzacions.

En el següent diagrama podem veure:

La branca principal
Es diu una nova branca feature
El camí que el feature realitza abans de fusionar-se amb main

Crear una branca per a una nova implementació o correcció d'errors és com desar un fitxer. Amb GitHub, els desenvolupadors de programari utilitzen branques per mantenir les correccions d'errors i el treball de funcions, separades de la branca de producció principal. Quan un canvi està preparat, es fusiona amb la branca mestra.

Creem una branca

Després de crear el nostre repositori, aneu a la pestanya <>Code(1) del repositori:

Feu clic al menú desplegable principal (2) i, a continuació, doneu un nom al nou branch (3)

Feu clic al seu Create branch: first branch from 'main'

Ara en tenim dos branch, main e first-branch. Ara mateix, semblen exactament iguals. Més endavant afegirem els canvis al nou branch.

Fer i confirmar canvis

Acaba de crear el nou branch, GitHub t'ha portat a code page pel nou first-branch, que és una còpia de main.

Podem fer i desar canvis als fitxers al repositori. A GitHub, es criden els canvis desats commit. Cada commit té un missatge de commit associat, que és una descripció que explica per què es va fer un canvi concret. Els missatges de commit recullen la història dels canvis perquè altres col·laboradors puguin entendre què es va fer i per què.

Sota la branca first-branch creat, feu clic al fitxer README.md i després al llapis per editar el fitxer.

A l'editor, escriu amb Markdown.

A la caixa Commit changes (Vista prèvia), escrivim un missatge de commit descrivint els canvis.

Finalment feu clic al botó Commit changes.

Aquests canvis només es faran al fitxer README first-branch, de manera que ara aquesta branca conté contingut diferent del principal.

Obertura d'un pull request

Ara que tenim canvis en una branca de la principal, podem obrir-ne un pull request.

Le pull request són el cor de la col·laboració a GitHub. Quan obriu a pull request, estàs proposant els teus canvis i demanant a algú que faci a review e pull de la teva aportació i fusionar-los a la seva branca. El pull request mostrar les diferències de contingut d'ambdues branques. Els canvis, les sumes i les restes es mostren en diferents colors.

Tan bon punt feu una confirmació, podeu obrir una sol·licitud d'extracció i iniciar una discussió, fins i tot abans que s'acabi el codi.

Utilitzant la funció @mention de GitHub al teu missatge de pull request, podeu demanar comentaris a persones o equips concrets, independentment de la seva ubicació.

Fins i tot pots obrir pull request al vostre repositori i fusioneu-los vosaltres mateixos. És una manera fantàstica d'aprendre el flux de GitHub abans de treballar en projectes més grans.

Per fer-ne un pull request has de:

• Feu clic a la pestanya pull request del teu repositori first-repository.

• Clic New pull request
• A la capsa Example Comparisons, selecciona la branca que has creat, first-branch, per comparar amb main (l'original).
• Reviseu els vostres canvis en les diferències a la pàgina Compara, assegureu-vos que són els que voleu enviar.

• Clic Create pull request.

• Posa un títol al teu pull request escriviu una breu descripció dels vostres canvis. Podeu incloure emojis i arrossegar i deixar anar imatges i gifs.

• Opcionalment, a la dreta del títol i la descripció, feu clic al costat de Revisors. Destinataris, etiquetes, projectes o fites per afegir qualsevol d'aquestes opcions a la vostra pull request. Encara no cal que els afegiu, però aquestes opcions ofereixen diverses maneres de col·laborar amb el vostre pull request.
• Clic Create pull request.

Els vostres col·laboradors ara poden revisar els vostres canvis i fer suggeriments.

Combina el teu pull request

En aquest pas final, fusionareu la vostra branca first-branch a la branca principal. Després de fusionar el pull request, canvis a la branca first-branch s'incrustarà al fitxer principal.

De vegades, una sol·licitud d'extracció pot introduir canvis de codi que entren en conflicte amb el codi existent a main. Si hi ha cap conflicte, GitHub us avisarà del codi en conflicte i evitarà la fusió fins que es resolguin els conflictes. Podeu fer una confirmació que resolgui els conflictes o utilitzar els comentaris de la sol·licitud d'extracció per parlar dels conflictes amb els membres del vostre equip.

• Clic Merge pull request per combinar els canvis en main.

• Clic Confirm merge. Rebràs un missatge que indica que la sol·licitud s'ha combinat correctament i que s'ha tancat.
• Clic Delete branch. Ara que el teu richiesta pull s'ha fusionat i els vostres canvis es troben al principal, podeu suprimir la branca amb seguretat first-branch. Si voleu fer més canvis al vostre projecte, sempre podeu crear una branca nova i repetir aquest procés.

Ercole Palmeri