Atelier-github pour @LesHackeuses at @42

Cet atelier présente les outils de collaboration et de versioning Git et Github.

Ouvert à toutes personnes souhaitant en savoir plus sur Github et ses utilisations.

Il n'est pas nécessaire de savoir coder pour participer à cet atelier.

Vous aurez besoin de votre ordinateur, d'une connexion à internet et d'un compte Github.

Le versionning et les outils de collaboration

Qu'est-ce que versioning?

La gestion de versions, permet simplement de pouvoir créer plusieurs versions d'un projet. Ces versions sont alors accessibles et modifiables. Le "versioning" permet un travail d'équipe simultané, c'est un outil primordial pour le travail collaboratif.

Il permet

• d'établir un historique des modifications
• de récupérer des versions anterieures du projet en cas de problème.

Qu'est-ce que Github?

Github est une plateforme web permettant d'héberger et de gérer des projets.

Qu'est-ce que Git?

Un gestionnaire de version qui permet d'enregister l'évolution d'un fichier ou d'un ensemble de fichiers. Il permet de conserver toutes les versions d'un projet.

Les versions contiendrons ces informations:

• Quand le fichier a été modifié
• Quoi: le détail de ce qui a été modifié
• Pourquoi le fichier a été modifié
• Qui a fait ce changement

Github

Créer son premier dépot

1. Cliquer en haut à droite dans le menu + et sélectionner "New repository"
2. Nommer son repository
3. Ajouter une description (optionnel)
4. Choisir de rendre le repository "Public" ou "Privé"
5. Initialiser le repo avec un README
6. Cliquer sur créer

Git

Installation

https://www.linode.com/docs/development/version-control/how-to-install-git-on-linux-mac-and-windows/

Cloner un repository

# cloner un repository existant
git clone [email protected]:camilleregnault/atelier-github.git

Ligne de commande Git

Commandes

# visualiser les commandes git
git --help

Commit

# d'abord verifier le status actuel
git status

# Ensuite, ajouter les fichier dans la "zone de transit"
git add <file_1_which_has_been_modified>
git add <file_2_which_has_been_modified>

# verifier le status
git status

# commenter/ decrire le changement
git commit --message "A meaningful message about this change"

Log

# visualiser l'historique des commits
git log

# press q to exit git log

Push

# Envoyer le commit sur github
git push origin <branch_name>

# envoyer sur la branche principale
git push origin master

Les branches

Ce sont des outils permettant le travail collaboratif. Github flow

# Créer un branche
git checkout -b <new_branch_name>

# Aller sur une branche
git checkout <branch_name>

# Aller sur master
git checkout master

Pull

# Récuperer et intégrer un branche ou un autre repo
git pull origin master

Merge

# Fusionner les branches dans master
git merge

Reférences et liens utiles

vidéo de présentation officielle de Github (en anglais): https://www.youtube.com/watch?v=w3jLJU7DT5E

commandes principales console + git: https://github.com/women-on-rails/week-1

Guide Git: https://rogerdudler.github.io/git-guide/

https://github.github.com/training-kit/downloads/fr/github-git-cheat-sheet/

Comprendre Git: https://blog.lesieur.name/comprendre-et-utiliser-git-avec-vos-projets/

Créer un repository Github: https://guides.github.com/activities/hello-world/#intro

Installer Git:

• https://www.linode.com/docs/development/version-control/how-to-install-git-on-linux-mac-and-windows/
• https://git-scm.com/downloads

Versioning: https://git-scm.com/book/fr/v1/D%C3%A9marrage-rapide-%C3%80-propos-de-la-gestion-de-version

Formater Readme: https://help.github.com/en/articles/basic-writing-and-formatting-syntax

Git github guide:https://rogerdudler.github.io/git-guide/index.fr.html

Lignes de commande git: https://gist.github.com/aquelito/8596717#file-git_base-md

Learning git branching: https://learngitbranching.js.org/

BONUS: https://myoctocat.com/