Collaboration et reproductibilité dans GitHub

Module 06

Passer d’un travail individuel à un flux collaboratif reproductible.

Fil principalGitHub, jointures et reproductibilité

Donnéesnycflights23 et tables reliées

DéfiRevue croisée d’un rapport collaboratif

Produit fini du module

Produit final

Un rapport collaboratif reproductible

Le module mène à un rapport Quarto versionné dans GitHub, enrichi par des données jointes, des visualisations et une trace claire des décisions d'équipe.

collaboration

branches

jointures

revue

rapport rendu issues

Objectifs du module

À la fin de ce module, vous devriez être capable de :

• collaborer efficacement sur un projet de science des données avec GitHub;
• utiliser branches, commits et pull requests dans un contexte d’équipe;
• fusionner plusieurs tables avec dplyr;
• produire un rapport Quarto reproductible;
• formuler une rétroaction constructive dans une issue GitHub.

Préparer le module

Prérequis

Reprenez le dépôt GitHub du module 2 et un rapport Quarto rendu. Vous devez savoir localiser un fichier, lire l’historique des commits et reconnaître une jointure simple avant de commencer.

Parcours minimal

Lisez le README, vérifiez une jointure, rendez un rapport et rédigez une issue précise. Le but est de rendre le travail d’une autre équipe compréhensible et actionnable.

Travail d’équipe

Une issue utile nomme un élément réussi, une suggestion précise, l’endroit concerné et sa justification. Restez sur le travail observable, jamais sur la personne.

Si l’équipe attribuée bloque

Documentez ce que vous avez pu vérifier, n’inventez pas de problème et signalez rapidement la situation à l’enseignant·e ou à l’auxiliaire. Ne restez pas dépendant d’une réponse externe.

Plan d’apprentissage

Les cartes reprennent les quatre blocs du plan: lectures, aventure, défi, exercices. L’aventure et le défi forment le fil narratif du module. Les exercices sont indépendants et servent à consolider les jointures, la reproductibilité et la revue constructive sur d’autres données.

1 Lectures à faire Préparer collaboration GitHub, pull requests, issues et jointures. Mini-test Ouvrir la carteRéduire

Lectures du module 6

Ces lectures préparent le travail collaboratif: suivre l'historique, discuter une modification, ouvrir une issue utile et joindre des tables.

Collaboration GitHub

• GitHub Docs - Flux GitHub
  Comprendre branches, commits, pull requests et fusion dans un flux de collaboration.
• GitHub Docs - Créer une issue
  Formuler une rétroaction utile et actionnable dans le dépôt d'une équipe.

Jointures avec dplyr

• R for Data Science - Joins
  Relier plusieurs tables avec des clés et vérifier les lignes qui apparaissent ou disparaissent.
• dplyr - Mutating joins
  Référence des fonctions left_join(), inner_join(), right_join() et full_join().

Aide-mémoires Posit

• Data transformation with dplyr :: Cheatsheet
  Jointures, regroupements et vérifications de tables.
• Publish and Share with Quarto :: Cheatsheet
  Produire un rapport reproductible en équipe.

Faire le mini-test formatif des lectures.

2 Aventure Produire un rapport collaboratif sur les retards de vols à JFK. Aventure Ouvrir la carteRéduire

Objectif Utiliser GitHub, Quarto et nycflights23 dans un travail d'équipe.

Ressource Page Aventure

À produire rapport.qmd, rapport.html et README.md.

3 Défi Faire une revue croisée claire et actionnable. Défi Ouvrir la carteRéduire

Défi - Revue croisée

Vous évaluez le rapport d'une autre équipe comme collaborateur: vérifier la reproductibilité, formuler des issues utiles et répondre aux corrections.

• But: produire une rétroaction précise, actionnable et liée au code ou au rapport.
• Livrables: issues GitHub, réponses et corrections retenues.
• Point d'attention: une bonne issue doit permettre à l'équipe de savoir quoi modifier.

La consigne complète est disponible dans la page Défi 6.

4 Exercices Pratiquer les jointures sur un véritable catalogue québécois. Exercices Ouvrir la carteRéduire

Objectif Consolider les jointures, les diagnostics de clés et les revues GitHub.

Ressource Page Exercices

Portée Ces exercices ne sont pas la suite du défi. Ils utilisent un extrait relationnel réel de Données Québec: organisations, jeux, ressources et étiquettes.

Données et outils

Bases de données

Télécharger le dossier de travail du module (.zip)

nycflights23::flights nycflights23::airlines nycflights23::weather Organisations de Données Québec Jeux de Données Québec Ressources de Données Québec Étiquettes de Données Québec

Packages R

tidyverse nycflights23 dplyr readr ggplot2

Révision et prolongement

Finir le module avec l’IA du cours

Relisez une issue que vous avez écrite, puis ouvrez la page IA ou GPT STT-1100 et demandez une rétroaction ciblée:

Voici une issue de revue que j'ai écrite. Est-elle assez précise pour qu'une équipe agisse? Repère une formulation vague, une information manquante et une amélioration que je peux faire moi-même.