Créer un devoir individuel

Vous pouvez créer un devoir pour les étudiants de votre cours à faire individuellement.

Qui peut utiliser cette fonctionnalité ?

Organization owners who are admins for a classroom can create and manage individual 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 individuels

Un devoir individuel est un travail attribué à chaque étudiant qui participe à un cours sur GitHub Classroom. L’étudiant est censé réaliser un devoir individuel sans aide d’autres étudiants.

Quand un étudiant accepte un devoir, GitHub Classroom crée automatiquement un dépôt pour celui-ci. Vous pouvez partir d’un dépôt vide, ou vous pouvez créer un dépôt à partir d’un modèle de dépôt comportant du code de démarrage, de la documentation, des tests et d’autres ressources. Chaque dépôt de devoirs appartient à votre compte d’organisation sur GitHub.

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 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 et la visibilité des dépôts de devoir.

Nommage d’un devoir

Pour un devoir individuel, GitHub Classroom nomme les dépôts avec le préfixe du dépôt et le nom d’utilisateur GitHub de l’étudiant. 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 d’utilisateur de l’étudiant sur GitHub est @octocat, le nom du dépôt de devoir pour @octocat est assignment-1-octocat.

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 et cliquez sur Devoir individuel. Vous ne pouvez pas changer le type de devoir après l’avoir créé. Si vous préférez créer un devoir de groupe, consultez Créer 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 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 étudiant de la liste de classe. 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.

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

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.

Envoi de commentaires pour un devoir

Vous pouvez aussi évaluer automatiquement les devoirs et créer un espace pour discuter de chaque envoi avec l’étudiant.

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 si un étudiant a rejoint la classe, et a accepté ou envoyé un devoir sous l’onglet Liste de classe du devoir. Vous pouvez également lier les alias GitHub des étudiants à leur identificateur de liste de classe et vice versa sous cet onglet. 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