Collaboration et reproductibilité dans GitHub
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.
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 cinq étapes du plan: lectures, aventure, défi, exercices et rétroaction IA. 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. La rétroaction IA revient sur un élément du travail déjà réalisé; elle ne demande aucune remise supplémentaire.
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 fonctionsleft_join(),inner_join(),right_join()etfull_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.
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.
5 Rétroaction IA Faire relire un extrait du travail, puis décider quoi améliorer soi-même. Mode /retroaction Ouvrir la carteRéduire
Point de départ Choisissez un seul élément réellement produit dans l'aventure, le défi ou les exercices: un extrait de code, un graphique, une interprétation ou un choix méthodologique.
Préparer Donnez la consigne, le contexte, ce que vous avez essayé et l'élément précis à relire.
Demander Ouvrez GPT STT-1100 en mode /retroaction. Demandez un point solide, une fragilité à vérifier et une question qui vous aidera à corriger.
Décider Comparez la réponse aux données et à la consigne. Modifiez vous-même seulement ce que vous comprenez et pouvez expliquer.
Demande prête à copier
/retroaction Je termine ce module. Voici la consigne visée, ce que j'ai essayé et l'extrait précis que je veux améliorer. Donne-moi un point solide, une fragilité à vérifier et une question qui m'aidera à corriger moi-même. Ne réécris pas tout le travail.
Résultat attendu Une amélioration comprise et appliquée dans votre travail, ou une raison claire de ne pas suivre la suggestion. Il n'y a ni portfolio ni remise supplémentaire à produire.
Confidentialité Ne transmettez aucune donnée personnelle, confidentielle ou protégée.