Soutien technique

Cette page regroupe les procédures de dépannage et les ressources de rattrapage.

Pour installer R, RStudio ou Positron, Git et Quarto, puis configurer GitHub avec SSH, commencer par le guide Installation et vérification technique.

Diagnostic initial

Deux diagnostics non notés ont des rôles distincts.

Avant la première séance, l’autodiagnostic des bases de R vérifie:

  • objets, vecteurs et sous-ensembles;
  • valeurs manquantes et conditions logiques;
  • importation d’un fichier;
  • manipulation simple de données;
  • petite fonction;
  • lecture d’un message d’erreur et vérification d’un résultat.

Pendant la mise en route, le diagnostic technique de la semaine 1 vérifie l’accès à R, Git, Quarto et à l’éditeur de code. Ces outils sont ensuite travaillés dans le cours.

Les commandes à exécuter et les résultats attendus sont regroupés dans la section Vérification technique complète.

Les diagnostics servent à orienter le soutien, pas à classer les étudiantes et étudiants. Le parcours de mise à niveau des bases de R propose une révision ciblée selon le résultat.

Question technique efficace

Inclure:

  • le système utilisé;
  • la version de R;
  • la commande exécutée;
  • le message d’erreur complet;
  • un exemple minimal reproductible;
  • ce qui était attendu;
  • ce qui a été obtenu.

Erreurs fréquentes

Symptôme Diagnostic rapide Correction habituelle
GitHub refuse git push Tester ssh -T git@github.com Configurer ou corriger la clé SSH GitHub
Le fichier est introuvable Vérifier pwd et list.files() Revenir au bon projet et utiliser des chemins relatifs
Un package manque Lire le message there is no package called Installer le package ou relancer renv::restore()
Le rendu Quarto échoue Relire le premier message d’erreur utile Exécuter le bloc R fautif dans la console, puis relancer quarto render
Le code fonctionne seulement sur un ordinateur Chercher des chemins comme /Users/... ou C:\\... Remplacer par des chemins relatifs et documenter les données
Un fichier de données manque Vérifier data/raw/ et la fiche de provenance Ajouter la source, le script de téléchargement ou l’instruction de récupération
Conflit Git Chercher les marqueurs <<<<<<<, =======, >>>>>>> Résoudre manuellement, tester, puis créer un commit de résolution
renv bloque une installation Lire le message de paquet ou de version R Restaurer l’environnement ou documenter la dépendance manquante

Procédures utiles

Tester l’authentification GitHub par SSH:

ssh -T git@github.com

Vérifier que le dépôt courant est le bon:

pwd
git status
git remote -v

Relancer un projet avec renv:

renv::restore()

Rendre un document Quarto:

quarto render rapport.qmd

Chercher un conflit Git:

git status
grep -R "<<<<<<<" .

IA et dépannage

L’IA peut aider à comprendre une erreur si le statut d’IA de la tâche le permet. Ne jamais transmettre de données sensibles ou confidentielles à un outil externe non approuvé.

Ressources de rattrapage

Les ressources de rattrapage couvrent au minimum:

Authentification GitHub

L’authentification GitHub doit être configurée avant les remises qui utilisent un dépôt distant. La méthode privilégiée est SSH lorsque l’environnement de la personne étudiante le permet.

Référence officielle: GitHub Docs, Connecting to GitHub with SSH: https://docs.github.com/en/authentication/connecting-to-github-with-ssh.

FAQ vivante

Les questions récurrentes seront ajoutées ici au fil de la session, avec une réponse courte et une procédure de diagnostic reproductible.