Créer un devoir de groupe

Vous pouvez créer une affectation collaborative pour des équipes d’étudiants qui participent à votre cours.

Qui peut utiliser cette fonctionnalité ?

Organization owners who are admins for a classroom can create and manage group assignments for a classroom. Pour plus d’informations sur les administrateurs de salle de classe, consultez Gérer les classes.

Dans cet article

À 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

  1. Connectez-vous à GitHub Classroom.
  2. Accédez à une classe.
  3. 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

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 par foo, *foo correspond à tous les fichiers se terminant par foo, et *foo* correspond à tous les fichiers dont les noms contiennent foo (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 dans set(y compris les jeux comme a-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

Pour aller plus loin