Rendre un devoir

Un seul dépôt pour le semestre : ap-homework

Tout votre travail du semestre tient dans un unique dépôt GitHub, que nous créons ensemble en fin de séance 1. Trois choses à retenir.

1. Créez un dépôt nommé exactement ap-homework, privé de préférence pour garder votre travail à l’abri du reste de la promotion : le même nom pour tout le monde, seul votre identifiant GitHub change. Vous obtenez donc github.com/<votre-compte>/ap-homework.

2. Si le dépôt est privé, ajoutez-moi en collaborateur : ushu, dans Settings → Collaborators → Add people. Sans cette invitation (envoyée et acceptée), un dépôt privé m'est parfaitement invisible, et votre rendu comptera pour manquant. C'est l'étape qu'on oublie : vérifiez-la.

3. Donnez-moi votre identifiant GitHub en séance. Pas l'URL : le nom du dépôt étant le même pour tous, votre identifiant me suffit.

Dans ce dépôt, un dossier par séance ou projet, à la racine. Ces noms de dossiers sont la convention qui fait tout fonctionner : c'est là que je viens chercher votre travail, et nulle part ailleurs.

Gardez les notebooks séparés. Un cycle peut occuper plusieurs dossiers, mais donne lieu à une seule collecte et une seule note. Pour présenter un notebook facultatif en bonus, ajoutez-le au dossier de sa séance ; aucun bonus n’est requis.

La date du commit fait foi. Pas celle du push, pas celle du fichier : celle du dernier commit qui touche votre rendu. Un commit fait à l'heure et poussé un peu plus tard est à l'heure ; un commit daté d'après l'échéance est un retard, même poussé avant. La collecte est automatique : je relève tous les dépôts à chaque échéance, vous n'avez aucun email à m'envoyer.

Les échéances (heure de Paris)

Pour une question ou un empêchement, écrivez àaurelien.noce@minesparis.psl.eu, avec aurelien.noce@imagine-app.fr en copie.

Un attendu annoncé en cours

Les notebooks suivent une progression. En fonction de notre avancement, je préciserai ceux que nous travaillons ensemble, ceux à terminer pour le rendu, et ceux qui restent facultatifs. Le nombre d’étapes disponibles n’est pas le nombre de devoirs à faire.

Le rendu de cycle reprend votre travail de séance : les notebooks annoncés, avec leurs vérifications et une courte explication. Pour ces rendus de cycle, aucun nouveau gros sujet à résoudre à la maison. Les prolongements non demandés peuvent apporter un bonus ; leur absence ne retire aucun point.

Dans votre copie, notez les consignes annoncées : notebooks retenus, fonctions ou traces attendues et point d’arrêt. Si vous bloquez, gardez l’essai effectué, le résultat observé et ce qui manque.

Un quiz de dix minutes en début de séance

À partir d’AP3, chaque séance s’ouvre par un quiz de dix minutes sur la séance précédente, corrigé ensemble dans la foulée. Le chapitre du poly à relire est annoncé à l’avance et suffit pour répondre à toutes les questions. Il n’y a pas de quiz en AP2, qui suit AP1 de deux jours.

Une reprise orale

À la séance qui suit le cycle — AP4 pour le premier — je vous demanderai d’expliquer une trace, de prédire une petite variante ou de justifier une représentation. Ces échanges alimentent la note de participation. La vitesse et le nombre de prises de parole ne sont pas des critères.

Les cycles suivants seront précisés en cours. AP9 lance des TP longs en semi-autonomie, à terminer à la maison, qui constituent le projet noté. Le catalogue AP9 regroupe les sujets et leurs squelettes par thèmes ; les nouveaux prototypes seront affinés avant janvier.

Les livebooks (AP1 à AP6)

Le rendu reprend vos fichiers .livemd de séance, avec leurs essais et vos explications. Il n’y a aucun nouveau sujet à résoudre à la maison, ni de gros notebook à reconstituer. Sauvegardez les étapes, même si un prolongement reste incomplet.

1. Depuis la page de la séance, cliquez sur Run in Livebookpour ouvrir l’atelier. Le lien de téléchargement permet aussi de récupérer le fichier .livemd sur votre ordinateur.

2. Si vous avez téléchargé le fichier, ouvrez-le depuis l’accueil de Livebook. Besoin d’installer Livebook ? Tout est expliqué dans la leçon « Installer Livebook » de la séance 1.

3. Complétez les cellules là où c’est demandé, en évaluant au fur et à mesure. Les cellules de vérification vous disent si vous êtes sur la bonne voie.

4. Enregistrez le notebook complété (Ctrl/Cmd + S). Relancez les cellules que vous avez réalisées depuis une session neuve. Pour une étape inachevée, conservez votre tentative et expliquez le résultat attendu, le souci rencontré et ce que vous avez vérifié.

5. Déposez le .livemd dans le dossier de la séance : AP1/ pour la séance 1, AP2/ pour la séance 2, et ainsi de suite. Puis git add, git commit, git push. Pour AP2 et AP3, gardez les étapes travaillées, avec le point d’arrêt annoncé en cours. Les autres séances à Livebook gardent les fichiers indiqués dans le tableau. Les essais facultatifs peuvent rester dans entrainement/ ; pour les présenter en bonus, joignez-les au dossier du rendu annoncé.

L’échéance confirmée du cycle 1 est le dimanche 6 décembre à 23 h 59, heure de Paris. Aucun travail n'est demandé entre les séances du 27 et du 29 octobre :AP1, AP2 et AP3 se rendent ensemble le dimanche 6 décembre.

Les projets git (AP6 et au-delà)

AP6 se déroule surtout dans Livebook et se termine par la création d’un projet Mix. AP7 et AP8 utilisent ensuite des squelettes fournis, avec leurs modules et leurs tests. Le README du projet explique comment démarrer et vérifier chaque étape.

1. Téléchargez le zip du squelette depuis la page de la séance, et dézippez-le à la racine de votre dépôt ap-homework. L'archive contient déjà un dossier au bon nom (compteur-local/ par exemple) : rien à renommer, rien à déplacer.

2. Surtout, pas de git init dans ce dossier. Le README du squelette vous le dira aussi. Un dépôt git à l'intérieur d'un autre, et votre travail ne quitte jamais votre machine : il ne sera ni poussé, ni relevé, ni corrigé. Votre dépôt ap-homework existe déjà, le projet n'est qu'un dossier de plus dedans.

3. Travaillez par petits pas, en commitant chaque étape qui marche, et poussez régulièrement (git push). On ne garde pas tout en local jusqu'à la dernière minute, car l'historique fait partie du rendu.

Pour AP8, conservez le projet compteur-replique/ et une trace des échanges. Pour AP9, le sujet choisi se poursuit à la maison : le dossier du squelette suffit, sans le renommer en projet/.

AP9 lance le projet noté, à poursuivre à la maison. Le périmètre, le barème et l’échéance seront précisés avant le lancement ; chaque sujet possède son squelette et son parcours de vérification. L’ancienne remise en fin de séance et la règle de bonus pour le travail après le cours ne s’appliquent plus.

Quelques conseils

• Commitez souvent, par petites touches. Un commit à chaque étape qui marche vaut mieux qu'un gros commit fourre-tout à la fin. En prime, si quelque chose casse, vous savez exactement quand.
• Écrivez des messages de commit clairs. « corrige la division par zéro » en dit long ; « maj » ou « wip » n'aident personne, à commencer par vous dans deux semaines.
• N'oubliez pas de pousser. Tant que vous n'avez pas fait git push, votre travail ne quitte pas votre machine. Rechargez la page de votre dépôt dans le navigateur pour vérifier qu'il est bien arrivé.
• On évalue la démarche autant que le résultat. Un raisonnement clair, un code lisible, des essais commentés comptent, même si tout n'est pas parfaitement fini. Montrez comment vous avez cherché.

Retour à l'accueil