Github tutorial

Referències

• https://docs.github.com/en/get-started/quickstart/hello-world

Introducció

Aquest petit tutorial t'ensenyarà allò essencial de GitHub com ara repositoris, branques, commits, i pull requests. Crearàs el tey repositori Hello World i faràs el flux d'un pull request, que és la manera usual de crear i revisar el codi.

Com a pas previ necessites un compte de GitHub, associat al teu correu del domini jaumebalmes.net.

Part I

En aquesta primera part només treballaràs en l'entorn de github.com. Tots els canvis que facis els faràs des de la web de GitHub (el repositori remot).

Seguiràs pas a pas el tutorial, i no tindràs cap problema per fer:

1. Crear un repositori
2. Crear una branca
3. Fer commit dels canvis
4. Obrir un pull request
5. Fer un merge del pull request
6. Eliminar la branca que ja no fas servir.

Part II

Ara seguirem la mateixa idea que hem fet abans, però la idea és treballar des de la nostra consola i sincronitzar el nostre repositori local amb el repositori remot.

El primer que farem és descarregar-nos el repositori:

$ git clone https://github.com/jquintanabalmes/hello-world
$ cd hello-world

$ ls -la
drwxrwxr-x 8 joan joan 4096 de març  16 19:12 .git
-rw-rw-r-- 1 joan joan   34 de març  16 19:12 README.md

$ git status
En la branca main
La vostra branca està al dia amb «origin/main».

no hi ha res a cometre, l'arbre de treball està net

És a dir, estem en la branca main (que és la única que hi ha). Ara crearem una nova branca:

$ git checkout -b readme-edits
S'ha canviat a la branca nova «readme-edits»

Per saber les branques que tenim:

$ git branch -a
  main
* readme-edits
  remotes/origin/HEAD -> origin/main
  remotes/origin/main

Ara ja podem editar el fitxer README.md

$ nano README.md

i fem algunes modificacions

Fem el commit dels canvis que hem fet:

$ git commit -a -m "noves modificacions"
[readme-edits 18d3c7b] noves modificacions
 1 file changed, 1 insertion(+)

I ara ja puc veure com el README.md té versions diferents en la branca main i en la branca readme-edits.

Per veure les diferències entre les dues branques:

$ git diff main readme-edits

diff --git a/README.md b/README.md
index 2f2ae3b..f241a33 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,3 @@
 # hello-world
 canvis en el readme
+fem algunes modificacions més
\ No newline at end of file

S'ha de saber interpretar la informació que se'ns mostra.

I ara vull incorporar a la branca main els canvis que he fet en la branca readme-edits.

Primer canvio a la branca main:

$ git checkout main

(comprovar que estic en la versió antiga fent nano README.md)

Faig el merge de la readme-edits a la branca main (la branca actual)

$ git merge readme-edits
S'estan actualitzant b201e08..18d3c7b
Fast-forward
 README.md | 1 +
 1 file changed, 1 insertion(+)

Comprovo que el fitxer README.md té incorporats els nous canvis:

$ cat README.md

I ara ja puc actualitzar la branca main del remot. Primer he de fer un commit de la branca main, i després ja puc fer un push al remot:

$ git commit -a -m "nous canvis a main"

$ git push origin main
username:
password:

Per tant, ara si mirem el fitxer README.md del remot veurem els canvis que hem realitzat.

Tasques a realitzar

Aquest és un tutorial molt bàsic de Github, però amb el que aprens aquí en n'has de tenir prou per afrontar el treball col·laboratiu que faràs en el M12 (Projecte).

Has de fer les dues parts d'aquest tutorial, i entregar les evidències de què ho has fet tu i en la teva màquina.

Recorda que has de donar-te d'alta al GitHub amb el compte del jaumebalmes.net.

Entrega

Entregaràs un pdf amb les evidències de què has fet aquesta pràctica de forma individual i en la teva màquina.

---

creat per Joan Quintana Compte, març 2022