Remarque : en janvier 2024, GitHub Classroom modifient la façon dont les référentiels des étudiants sont créés à partir de référentiels de code de démarrage. Actuellement, le processus nécessite que les référentiels de code de démarrage soient des modèles et GitHub Classroom crée un référentiel pour chaque étudiant en fonction de ce modèle. Avec la modification à venir, les référentiels d’étudiants seront créés en utilisant en dupliquant le référentiel de code de démarrage.
Cette modification répond à une caractéristique demandée fréquente par les enseignants : la possibilité de modifier le code de démarrage une fois qu’un devoir a été accepté par les étudiants.
Vous pouvez en savoir plus sur cette modification sur le blog GitHub.
Cette caractéristique est en bêta publique et est sujette à modifications.
Le devoir de démarrage Git et GitHub est un cours prédéfini qui résume les principes de base de Git et GitHub, et propose aux étudiants des liens vers des ressources pour en savoir plus sur des sujets spécifiques.
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 du devoir de démarrage
S’il n’y a pas encore de devoirs dans la classe
- Connectez-vous à GitHub Classroom.
- Accédez à une classe.
- Sous l’onglet Devoirs, cliquez sur Utiliser le devoir de démarrage.
S’il y a déjà des devoirs dans la classe
- Connectez-vous à GitHub Classroom.
- Accédez à une classe.
- Sous l’onglet Devoirs, cliquez sur le lien dans la bannière bleue.
Configuration des éléments de base d’un devoir
Importez le cours de démarrage dans votre organisation, donnez un nom à votre devoir, choisissez éventuellement une échéance ainsi que la visibilité des dépôts de devoir.
- Composants requis
- Création du devoir de démarrage
- Configuration des éléments de base d’un devoir
- Invitation d’étudiants à un devoir
- Étapes suivantes
- Pour aller plus loin
Importation du devoir
Pour importer le devoir de démarrage Git et GitHub dans votre organisation, cliquez sur Importer le devoir.
Nommage du 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’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 dépôts privés, seul l’étudiant peut voir les commentaires que vous fournissez. Sous « Visibilité du dépôt », sélectionnez une visibilité.
Quand vous avez terminé, cliquez sur Continuer. GitHub Classroom crée le devoir et vous dirige vers la page du devoir.
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 si un étudiant a rejoint la classe et a accepté ou envoyé un devoir sous l’onglet Tous les étudiants 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.
Le devoir de démarrage Git et GitHub est disponible seulement pour les étudiants individuels, pas pour les groupes. Une fois que vous avez créé le devoir, les étudiants peuvent commencer à travailler dessus.
Étapes suivantes
- Personnaliser des devoirs supplémentaires pour votre cours. Pour plus d’informations, consultez « Créer un devoir individuel », « Créer un devoir de groupe » et « Réutiliser un devoir ».