Skip to main content

Créer un devoir de groupe

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

Who can use this feature

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 classe, consultez « À propos de la gestion des classes ».

À 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 ».

Pour une démonstration vidéo de la création d’un devoir de groupe, consultez « Concepts de base de la configuration de GitHub Classroom ».

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 Devoirs, créez le devoir.
    • S’il s’agit de votre premier devoir, cliquez sur Créer un devoir. Création de votre premier devoir
    • Sinon, cliquez sur Nouveau devoir. Bouton « Nouveau devoir »

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.

Entrez un titre pour le devoir. Si vous le souhaitez, cliquez sur pour modifier le préfixe.

Assignment title and prefix

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.

Date picker for assignment deadline

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.

Conseils :

  • 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.

Paramètres des équipes participant à un devoir de groupe

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 référentiels » et « Rôles de référentiel 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.

Visibility options for assignment repositories

Lorsque vous avez terminé, cliquez sur Continuer afin de configurer le code de démarrage et un environnement de développement pour le devoir.

'Continue' button

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 sur les modèles de dépôt, consultez « Création d’un modèle de dépôt ».

Remarque : 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.

Using the 'Select a repository' drop-down menu to find a template repository to use as starter code for an assignment

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 « Utilisation de 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.

Using the 'Select an online IDE' drop-down menu to click an online IDE for the assignment

Quand vous avez terminé, cliquez sur Continuer pour configurer l’évaluation automatique et les commentaires pour le projet.

'Continue' button

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 « Méthodes d’évaluation ».

Using the 'Add test' drop-down menu to click a grading method

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.

'Save test case' button for an autograding test

Vous pouvez ajouter d’autres tests avec le menu déroulant Ajouter un test, puis modifier ou supprimer des tests existants avec ou .

Pencil and trash icons to edit or delete an autograding test

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 « Révision des modifications apportées dans les 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.

Checkbox for 'Enable feedback pull requests'

Pour créer l’affectation, cliquez sur Créer une affectation.

'Create assignment' button

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.

Avertissement : 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.

Group assignment

Monitoring de la progression des étudiants

La page de présentation des devoirs montre des informations sur les devoirs que vous avez acceptés et la progression de l’équipe. Vous pouvez avoir des informations récapitulatives différentes en fonction des configurations de vos devoirs.

  • Nombre total d’équipes : nombre d’équipes créées.
  • Étudiants inscrits : nombre d’étudiants sur la liste de classe.
  • Étudiants sans équipe : nombre d’étudiants de la liste de classe Classroom qui n’ont pas encore rejoint une équipe.
  • Équipes ayant accepté : nombre d’équipes qui ont accepté ce devoir.
  • Envois de devoir : nombre d’équipes qui ont envoyé le devoir. L’envoi est déclenché à l’échéance du devoir.
  • Équipes ayant réussi : nombre d’équipes qui réussissent actuellement les tests d’évaluation automatique pour ce devoir.

Étapes suivantes

Pour aller plus loin