À propos des devoirs de groupe
Un devoir de groupe est un travail de cours collaboratif destiné à des groupes d’étudiants sur GitHub Classroom. Les étudiants peuvent travailler à plusieurs sur un devoir de groupe dans un dépôt partagé, comme une équipe de développeurs professionnels.
Quand un étudiant accepte un devoir de groupe, il peut créer une équipe ou rejoindre une équipe existante. GitHub Classroom enregistre les équipes d’un devoir sous forme d’ensemble. Vous pouvez nommer l’ensemble des équipes pour un devoir spécifique quand vous créez le devoir, et vous pouvez réutiliser cet ensemble d’équipes pour un devoir ultérieur.
Pour chaque affectation de groupe, GitHub Classroom crée automatiquement un dépôt partagé unique auquel l’équipe peut accéder. Le dépôt peut être vide, ou vous pouvez le créer à partir d’un modèle de dépôt avec du code de démarrage, de la documentation, des tests et d’autres ressources. Le dépôt appartient au compte de votre organisation sur GitHub, et GitHub Classroom accorde l’accès aux équipes que les étudiants créent ou rejoignent lors de l’acceptation de l’affectation.
Chaque devoir a un titre et une échéance facultative. Vous pouvez choisir si les dépôts créés par GitHub Classroom sont visibles ainsi que les autorisations d’accès. Vous pouvez également noter automatiquement les devoirs et créer un espace dédié pour discuter du devoir avec l’étudiant.
Vous pouvez choisir le nombre d’équipes d’un devoir et le nombre de membres de chaque équipe. Chaque équipe créée par un étudiant pour un devoir est une équipe au sein de votre organisation sur GitHub. La visibilité de l’équipe est secrète. Les équipes que vous créez sur GitHub n’apparaissent pas dans GitHub Classroom. Pour plus d’informations, consultez « À propos des équipes ».
Vous pouvez réutiliser des affectations existantes dans n’importe quelle autre classe pour laquelle vous disposez d’un accès administrateur, notamment les classes d’une autre organisation. Pour plus d’informations, consultez « Réutiliser un devoir ».
Prérequis
Vous devez créer une classe avant de pouvoir créer une attribution. Pour plus d’informations, consultez « Gérer les classes ».
Création d’un devoir
- Connectez-vous à GitHub Classroom.
- Accédez à une classe.
- Sous l’onglet Affectations, créez l’affectation.
- S’il s’agit de votre premier devoir, cliquez sur Créer un devoir.
- Sinon, cliquez sur Nouveau devoir sur le côté droit.
Configuration des éléments de base d’un devoir
Nommez votre devoir, choisissez une échéance éventuelle, définissez des équipes et choisissez la visibilité des dépôts de devoir.
- Nommage d’un devoir
- Attribution d’une échéance pour un devoir
- Choix d’un type de devoir
- Définition d’équipes pour un devoir
- Choix d’une visibilité pour les dépôts de devoir
Nommage d’un devoir
Pour un devoir de groupe, GitHub Classroom nomme les dépôts avec le préfixe du dépôt et le nom de l’équipe. Par défaut, le préfixe du dépôt est le titre du devoir. Par exemple, si vous nommez un devoir « assignment-1 » et que le nom de l’équipe sur GitHub est « student-name », le nom du dépôt de devoir pour les membres de l’équipe est assignment-1-student-team
.
Sous « Titre du devoir », tapez un titre pour le devoir. Si vous le souhaitez, cliquez sur pour modifier le préfixe.
Attribution d’une échéance pour un devoir
Vous pouvez également attribuer une échéance à l’affectation. Sous « Échéance (facultatif) », cliquez dans le champ de texte, puis utilisez le sélecteur de dates pour attribuer une échéance.
Si vous le souhaitez, pour faire de l’échéance une date limite, sélectionnez Il s’agit d’une date limite. Si vous utilisez une date limite, les étudiants perdront l’accès en écriture à leurs dépôts de devoirs une fois la date limite passée, sauf s’ils reçoivent un report. Pour plus d’informations sur le report des échéances de devoirs, consultez « Report de l’échéance d’un devoir pour une personne ou un groupe ».
Choix d’un type de devoir
Sous « Devoir individuel ou de groupe », sélectionnez le menu déroulant, puis cliquez sur Devoir de groupe. Vous ne pouvez pas changer le type de devoir après l’avoir créé. Si vous préférez créer un devoir individuel, consultez « Créer un devoir individuel ».
Définition d’équipes pour un devoir
Si vous avez déjà créé un devoir de groupe pour la classe, vous pouvez réutiliser un ensemble d’équipes pour le nouveau devoir. Pour créer un ensemble avec les équipes que vos étudiants ont créées pour le devoir, tapez le nom de l’ensemble. Vous pouvez aussi taper le nombre maximal de membres de l’équipe et le nombre total d’équipes.
Note
- Nous vous recommandons d’ajouter des détails sur l’ensemble d’équipes dans le nom de l’ensemble. Par exemple, si vous voulez utiliser l’ensemble d’équipes pour un devoir, donnez-lui le nom du devoir. Si vous voulez réutiliser l’ensemble tout au long d’un semestre ou d’un cours, donnez-lui le nom du semestre ou du cours.
- Si vous voulez attribuer des étudiants à une équipe spécifique, donnez-leur un nom pour l’équipe et fournissez une liste de membres.
Choix d’une visibilité pour les dépôts de devoir
Les dépôts d’un devoir peuvent être publics ou privés. Si vous utilisez des référentiels privés, seul l’étudiant ou l’équipe peut voir les commentaires que vous fournissez.
Vous pouvez également décider s’il faut accorder des autorisations d’administrateur des étudiants au référentiel pour un devoir. Accordez des autorisations d’administrateur si l’étudiant doit être en mesure d’effectuer des tâches d’administration pour le référentiel de devoirs. Pour plus d’informations, consultez « À propos des dépôts » et « Rôles de dépôt pour une organisation ».
Sous « Visibilité du dépôt », sélectionnez une visibilité. Si vous le souhaitez, sélectionnez Accorder à l’administrateur des étudiants l’accès à leur référentiel.
Lorsque vous avez terminé, cliquez sur Continuer afin de configurer le code de démarrage et un environnement de développement pour le devoir.
Ajout de code de démarrage et configuration d’un environnement de développement
Vous pouvez éventuellement décider de fournir des dépôts vides ou du code de démarrage, puis préconfigurer un environnement de développement pour vos étudiants.
Choix d’un modèle de dépôt
Par défaut, un nouveau devoir crée un dépôt vide pour chaque équipe créée par un étudiant. Vous pouvez éventuellement choisir un modèle de dépôt en tant que code de démarrage pour le devoir. Pour plus d’informations, consultez « Créer un devoir à partir d’un modèle de dépôt ».
Note
Le modèle de dépôt doit appartenir à votre organisation ou être un dépôt public sur GitHub.
Sous « Ajouter un modèle de dépôt pour donner aux étudiants un code de démarrage », sélectionnez la liste déroulante Sélectionner un dépôt, puis tapez une requête de recherche. Dans la liste des résultats, cliquez sur le modèle de dépôt que vous souhaitez utiliser pour le code de démarrage.
Choix d’un environnement de développement intégré (IDE)
Vous pouvez éventuellement configurer un devoir pour utiliser un IDE (environnement de développement intégré). Les IDE permettent aux étudiants d’écrire du code, d’exécuter des programmes et de collaborer sans installer Git ni une chaîne d’outils de développement complète sur leur ordinateur. Si vous choisissez un IDE pour un devoir, les étudiants peuvent toujours extraire et exécuter du code localement sur un ordinateur disposant des logiciels nécessaires. Pour plus d’informations, consultez « Intégrer GitHub Classroom à un IDE ».
Vous pouvez choisir de configurer une affectation avec GitHub Codespaces pour permettre aux étudiants d’accéder à un environnement Visual Studio Code basé sur un navigateur avec une configuration en un clic. Pour plus d’informations, consultez « Utiliser GitHub Codespaces avec GitHub Classroom ».
Pour choisir un IDE lié au devoir, sélectionnez le menu déroulant Ajouter un éditeur, puis cliquez sur l’IDE que vos étudiants doivent utiliser.
Quand vous avez terminé, cliquez sur Continuer pour configurer l’évaluation automatique et les commentaires pour le projet.
Formulation de commentaires
Vous pouvez aussi évaluer automatiquement les devoirs et créer un espace pour discuter de chaque envoi avec l’équipe.
Test automatique des devoirs
Vous pouvez utiliser la notation automatique afin de vérifier automatiquement un devoir effectué par un étudiant sur GitHub Classroom. Vous configurez des tests pour une assignation, et les tests s’exécutent immédiatement chaque fois qu’un étudiant procède à un envoi (push) vers un référentiel d’assignations sur GitHub.com. L’étudiant peut consulter les résultats des tests, apporter des modifications et procéder à des envois (push) pour consulter de nouveaux résultats. Pour plus d’informations, consultez « Utiliser l’évaluation automatique ».
Sous « Ajouter des tests d’évaluation automatique », sélectionnez le menu déroulant Ajouter un test, puis cliquez sur la méthode d’évaluation à utiliser. Pour plus d’informations, consultez « Utiliser l’évaluation automatique ».
Définissez les paramètres de votre cas de test, comme le nom, les commandes, les entrées, les sorties, le délai d’expiration et les points. Quand vous avez terminé, cliquez sur Enregistrer le cas de test.
Vous pouvez ajouter d’autres tests avec le menu déroulant Ajouter un test, puis modifier ou supprimer des tests existants avec ou .
Désignation de chemins d’accès de fichier protégés
Si votre devoir comporte des fichiers ou des répertoires utilisés dans le processus de notation ou qui ne doivent pas être modifiés par les étudiants, vous pouvez les désigner comme chemins de fichier protégés. Si un étudiant modifie un fichier protégé, une étiquette est appliquée à sa soumission sur la page vue d’ensemble du devoir pour vous permettre d’examiner. Pour plus d’informations, consultez « Surveiller la progression des étudiants avec la page de vue d’ensemble de devoir ».
Les modèles pour les chemins protégés suivent des règles similaires aux caractères génériques utilisés dans les noms de fichier shell. Ils peuvent contenir les méta-caractères suivants :
*
: correspond à n’importe quel fichier. Par exemple,*
correspond à tous les fichiers réguliers,foo*
correspond à tous les fichiers commençant parfoo
,*foo
correspond à tous les fichiers se terminant parfoo
, et*foo*
correspond à tous les fichiers dont les noms contiennentfoo
(y compris au début ou à la fin)**
: correspond aux répertoires de manière récursive ou aux fichiers de manière étendue. Par exemple,.github/**/*
correspond à tous les fichiers dans.github
et ses sous-répertoires?
: correspond à n’importe quel caractère[set]
: correspond à n’importe quel caractère dansset
(y compris les jeux commea-z
)\
: échappe le méta-caractère suivant
Création d’une demande de tirage pour les commentaires
Vous pouvez créer automatiquement une demande de tirage dans laquelle vous pouvez fournir des commentaires et répondre aux questions d’un étudiant sur une affectation. Pour plus d’informations sur la révision des modifications apportées dans une demande de tirage, consultez « Revue des modifications apportées dans les demandes de tirage ». Pour plus d’informations sur la façon de laisser des commentaires dans une demande de tirage, consultez « Laisser des commentaires en utilisant des demandes de tirage ».
Pour créer des demandes de tirage pour la discussion sur les commentaires, sélectionnez Activer les demandes de tirage sur les commentaires.
Pour créer l’affectation, cliquez sur Créer une affectation.
Invitation d’étudiants à un devoir
Par défaut, GitHub Classroom active une URL d’invitation pour chaque devoir que vous créez. Les étudiants peuvent accepter et envoyer le devoir tant que l’URL d’invitation est activée. Vous pouvez partager l’URL avec vos étudiants sur votre page d’accueil des cours du système de gestion des formations, ou tout autre emplacement où vous publiez des devoirs. Les étudiants peuvent également accéder au devoir sur GitHub Classroom s’ils ont déjà accepté un devoir pour la classe.
Warning
Soyez prudent quand vous partagez des URL d’invitation. Toute personne disposant d’une URL d’invitation pour un devoir peut accepter l’invitation et associer un compte personnel sur GitHub à un identificateur de votre liste.
Vous pouvez voir les équipes qui travaillent sur un devoir ou qui ont envoyé un devoir sous l’onglet Équipes du devoir. Pour empêcher l’acceptation ou la soumission d’une affectation par des étudiants, vous pouvez modifier le « Statut de l’affectation » dans la vue « Modifier l’affectation ». Quand une affectation sera active, les étudiants pourront l’accepter à l’aide du lien d’invitation. Quand elle sera inactive, ce lien ne sera plus valide.
Monitoring de la progression des étudiants
La page de présentation des devoirs fournit une vue d’ensemble des acceptations de vos devoirs et de la progression des étudiants. Pour plus d’informations sur l’affichage et l’utilisation de la page de vue d’ensemble de devoir, consultez « Surveiller la progression des étudiants avec la page de vue d’ensemble de devoir ».
Étapes suivantes
-
Une fois que vous avez créé le devoir et que vos étudiants ont formé des équipes, les membres d’équipe peuvent commencer à travailler sur le devoir en utilisant les fonctionnalités Git et GitHub. Les étudiants peuvent cloner le dépôt, pousser des commits, gérer des branches, créer et réviser des demandes de tirage, résoudre les conflits de fusion et discuter sur les changements en utilisant les problèmes. L’équipe et vous-même pouvez passer en revue l’historique des commits du dépôt. Pour plus d’informations, consultez « Bien démarrer avec la documentation GitHub », « Documentation sur les référentiels », « Utilisation de Git » et « Collaboration à l’aide de demandes de tirage » ainsi que le cours gratuit sur la résolution des conflits de fusion sur GitHub Skills.
-
Dès qu’une équipe a terminé un devoir, vous pouvez passer en revue les fichiers du dépôt ou l’historique et les visualisations du dépôt pour mieux comprendre comment l’équipe a collaboré. Pour plus d’informations, consultez « Consultation de l’activité et des données de votre dépôt ».
-
Vous pouvez fournir des commentaires sur un devoir en commentant des lignes ou des commits individuels dans une demande de tirage. Pour plus d’informations, consultez « Commentaires sur une demande de tirage » et « Création d’un problème ». Pour plus d’informations sur la création de réponses enregistrées afin de fournir des commentaires sur les erreurs courantes, consultez « À propos des réponses enregistrées ».