Skip to content

Commit

Permalink
git collab
Browse files Browse the repository at this point in the history
  • Loading branch information
avouacr committed Feb 5, 2024
1 parent 4e77445 commit 0395369
Show file tree
Hide file tree
Showing 3 changed files with 36 additions and 22 deletions.
3 changes: 2 additions & 1 deletion .gitignore
Original file line number Diff line number Diff line change
@@ -1,4 +1,5 @@
**/index_files
*.html
*.log
*.tex
*.tex
/.quarto/
50 changes: 34 additions & 16 deletions content/index.qmd
Original file line number Diff line number Diff line change
Expand Up @@ -109,14 +109,14 @@ L'activité du *datascientist* tend à se rapprocher de celle du développeur :

## Modalités pédagogiques

- Apprentissage par la [**pratique**]{.orange}
- Apprentissage par la pratique
- [Application](https://ensae-reproductibilite.github.io/website/chapters/application.html) : industrialisation d'un projet de ML

- [**Langage**]{.orange} : `Python`
- Langage : `Python` {{< fa brands python >}}
- Langage [**dominant**]{.blue2} dans le monde de la donnée
- Les principes présentés sont [**agnostiques**]{.blue2} au langage

- [**Environnement d'exécution**]{.orange} : [SSP Cloud](https://datalab.sspcloud.fr/)
- Environnement d'exécution : [SSP Cloud](https://datalab.sspcloud.fr/)
- Environnement de développement [**normalisé**]{.blue2}
- Véritable environnement de [**production**]{.blue2}
- Acquisition des [**bonnes pratiques**]{.blue2}
Expand All @@ -131,7 +131,14 @@ L'activité du *datascientist* tend à se rapprocher de celle du développeur :
- [**En groupe**]{.blue2} : [**projet**]{.blue2} à construire selon 3 "parcours"
- [**Individuel**]{.blue2} : [**revue de code**]{.blue2} d'un autre projet

# Git : rappels







# Le travail collaboratif avec `Git`

## Pourquoi utiliser Git ?

Expand Down Expand Up @@ -186,19 +193,34 @@ __Format des commits__

:::

## En pratique
## Outils pour le travail collaboratif

- L'éco-système `Git` [**facilite** le travail collaboratif]{.blue2}
- `Git` {{< fa brands git-alt >}} : modèle des [__branches__]{.orange}
- `GitHub` {{< fa brands github >}} / `GitLab` {{< fa brands gitlab >}} : [**Issues**, **Pull Requests**, **Forks**]{.orange}

## Le modèle des branches

- Git est un [**logiciel**]{.orange}
![](img/branches.png)

## Les outils de contribution

- [***Issue***]{.orange} : soumettre un [**problème**]{.blue2} ou une [**suggestion**]{.blue2} aux développeurs d'un projet

- [***Pull Request***]{.orange} : proposer aux développeurs d'un projet d'[**intégrer des modifications**]{.blue2}

- [***Fork***]{.orange} : faire la [**copie**]{.blue2} d'un projet existant dans son espace personnel
- Indispensable pour faire une *pull request* à un dépôt sur lequel on n'a pas les droits

## Une organisation courante : le *GitHub flow*

![](img/ghflow.png)

Description plus détaillée : [ici](https://docs.github.com/en/get-started/quickstart/github-flow)

- Utilisation en [**ligne de commande**]{.orange}

- Ressources sur le site :
- [Introduction au terminal Linux](https://linogaliana.github.io/ensae-reproductibilite-website/chapters/linux101.html)
- [Versionner son code et travailler collaborativement avec Git](https://linogaliana.github.io/ensae-reproductibilite-website/chapters/git.html)

## Application : initialisation du projet

- Consignes sur le [site du cours](https://linogaliana.github.io/ensae-reproductibilite-website/chapters/application.html#partie-0-initialisation-du-projet)



Expand Down Expand Up @@ -278,10 +300,6 @@ portion de code plus de deux fois ([**_don't repeat yourself_ (DRY)**]{.red2})
- [**Idéal**]{.orange} 💪 : documenter ses fonctions avec des *docstrings*
:::

## Application : qualité du code

- Consignes sur le [site du cours](https://linogaliana.github.io/ensae-reproductibilite-website/chapters/application.html#partie-1-qualit%C3%A9-du-script)




Expand Down
5 changes: 0 additions & 5 deletions render.sh

This file was deleted.

0 comments on commit 0395369

Please sign in to comment.