Démarrage étudiant

Cette page explique comment utiliser le site et se préparer au cours.

Avant la première séance

La fiche officielle du cours STT-4230 précise qu’une connaissance minimale de R est nécessaire. Faites d’abord l’autodiagnostic des bases de R. Selon le bilan obtenu, utilisez le parcours de mise à niveau avant la première séance.

Ce test porte sur les acquis antérieurs en R. La vérification de R, Git, GitHub et Quarto ci-dessous constitue une préparation technique distincte.

Préparer l’environnement suivant avant ou pendant le premier laboratoire:

Outil Attendu minimal Vérification
R Version récente installée localement R --version ou ouverture dans l’interface choisie
Quarto Installation fonctionnelle pour rendre un document quarto --version
Git Commandes de base disponibles git --version
GitHub Compte actif et accès au dépôt demandé connexion au site GitHub
SSH GitHub Clé SSH configurée lorsque possible ssh -T git@github.com
Interface R Positron ou RStudio ouverture d’un projet R

Si un outil manque ou si une commande échoue, suivre le guide Installation et vérification technique. Il présente les étapes pour Windows, macOS et Linux, puis une vérification complète de l’environnement.

Pour choisir l’interface qui vous convient et repérer les équivalences utiles, consulter la capsule RStudio ou Positron?. Les deux environnements sont acceptés dans le cours.

Si une étape bloque, noter le message exact et consulter Soutien technique.

Utiliser le site

Commencer par le module de la semaine dans Brio. Chaque module réunit la matière, la lecture, le mini-test lorsqu’il est prévu, le lien vers les exercices et la trace attendue dans le portfolio.

Préparation hebdomadaire

Avant la séance:

  • lire les notes courtes;
  • exécuter les exemples R;
  • répondre dans Brio au mini-test lorsqu’il est prévu;
  • travailler dans le dépôt personnel du portfolio;
  • noter une question ou une erreur à discuter.

GitHub

Avant le premier laboratoire, l’équipe enseignante crée un dépôt privé pour chaque personne inscrite à partir du modèle commun portfolio-stt4230-6230-a2026-template. Le dépôt est nommé portfolio-stt4230-IDUL pour une inscription à STT-4230 et portfolio-stt6230-IDUL pour une inscription à STT-6230. Dans les deux cas, IDUL correspond à l’identifiant ULaval de la personne étudiante. Le même dépôt est utilisé pendant toute la session.

La personne étudiante doit cloner le dépôt qui lui a été attribué. Elle ne doit pas créer un dépôt parallèle ni utiliser git init pour remplacer le dépôt du cours.

Exemple de dépôt cloné avec SSH:

git clone git@github.com:STT-4230-6230/portfolio-sttVOTRE-SIGLE-VOTRE-IDUL.git
cd portfolio-sttVOTRE-SIGLE-VOTRE-IDUL
git status

Remplacer VOTRE-SIGLE par 4230 ou 6230, selon l’inscription, et VOTRE-IDUL par l’identifiant utilisé dans le nom du dépôt attribué. Si le dépôt n’est pas visible ou si le clonage échoue, conserver le message d’erreur complet et demander à l’équipe enseignante de vérifier l’accès. Ne jamais copier une clé privée ou un jeton d’accès dans une demande d’aide.

La configuration SSH évite de manipuler des mots de passe ou jetons dans les scripts. Elle doit être testée avant les remises.

Vérification locale minimale

Dans le dépôt de travail, vérifier que les commandes suivantes fonctionnent:

pwd
git status
R --version
quarto --version

Dans R, vérifier aussi que les bibliothèques nécessaires peuvent être installées ou chargées:

library(tidyverse)

Si un projet contient un fichier renv.lock, relancer l’environnement avec:

renv::restore()

Remises

Les consignes préciseront le format exact: lien GitHub, fichier rendu, pull request, issue, rapport Quarto ou autre livrable.

Les mini-tests constituent une exception stable: ils sont toujours réalisés dans Brio. Ils ouvrent à 16 h 20 à la fin du cours précédent, ferment le mardi à 23 h 59, durent au plus 10 minutes et permettent une tentative.

Portfolio

Le portfolio est mis à jour chaque semaine. Il contient uniquement le travail personnel, pas les énoncés ni les corrigés fournis par le cours.

Une entrée hebdomadaire minimale contient généralement:

  • une trace issue d’une lecture, d’un exercice ou d’une activité du cours;
  • au moins un fichier produit personnellement;
  • une courte explication de ce qui a été tenté, vérifié et appris;
  • des commits lisibles;
  • une déclaration IA lorsque le statut de l’activité le demande.

Consulter les consignes complètes du portfolio avant le premier jalon.

Le clonage et la première personnalisation du dépôt sont décrits dans le laboratoire 1.

IA

Vérifier le statut d’IA pour chaque tâche. Si l’IA est utilisée de façon significative, documenter l’usage dans docs/ai-log.md.

Où trouver de l’aide

GPT du cours