Instructions pour le projet

Instructions pour le projet

Pour rappel, le projet final compte pour 40% de la note finale (environ 6 points sur le fond du projet lui-même et 2 points sur la présentation du 22 avril)

Contraintes du projet

Le projet doit être une ou plusieurs contributions de code non-triviales intégrées à un projet de logiciel libre d’ampleur.

Le logiciel doit :

  • être maintenu par une communauté active
  • avoir plus de 10 contributeurs
  • avoir plus de 12 mois d’existence
  • ne pas être une collection d’algorithmes ou de morceaux de codes petits et indépendants
  • être un véritable logiciel (pas un site web, vitrine, démo)
  • ne pas être un projet vibe-codé
  • ne pas être maintenu par une personne de votre entourage

Dans le doute, demandez-nous au plus tôt.

Vous devez signaler sur grist sur la ligne du logiciel votre intention d’y contribuer, afin de vous assurer qu’au plus un ou deux élèves contribuent à ce logiciel (cf limite par projet).

Dans son dossier sur le gitlab du cours, doivent être présents (mergés : Si les MR sont ouvertes il faut les finaliser ou corriger, sinon ouvrez une MR pour les fichiers manquants) :

  • Le fichier README.md qui présente le projet
  • Le fichier ANALYSIS.md qui s’assure notamment que le projet est actif (proposer une PR ignorée dans un projet connu en avance comme mort ne sera pas valable)
  • Le fichier DEVELOPMENT.md qui s’assure que vous avez la capacité technique de faire tourner ce projet sur votre environnement de développement (vérifier les instructions présentes si vous n’en êtes pas l’auteur)
  • Un fichier COMMUNICATION.md personnel qui permettait pour le rendu 4 de s’assurer qu’une contribution simple est rapidement mergée, avant de se lancer dans une contribution plus complexe, et dans lequel vous ajouterez une section : ```md ## Projet

```

[!IMPORTANT] Ouvrez votre MR dès votre premier contact avec le projet, et laissez-la en Draft: tant qu’elle n’est pas finalisée (projet terminé).

Exemples de contributions (2024-2025):

Présentation/slides

Deadline: Vous devez avoir rendu vos slides avant le 20 avril à minuit.

  • Envoyer entre 1 et 4 slides (limite stricte, recommandation = 2) pour le 20/04 à minuit sur ce formulaire.
  • Les slides seront compilés dans un ordre qui sera annoncé le jour des soutenances (22/04). Vous aurez un document imprimé avec tous les horaires de passage à la seconde près.
  • Présentation de 2 minutes (strictes) avec 10 secondes de temps de bascule entre chaque présentation.
  • Contenu demandé : présentation du projet, de votre contribution (inclure notamment le diff s’il tient sur une slide et/ou des captures d’écran de la pull request / de l’effet du changement dans le logiciel), et de votre expérience (difficultés techniques, communication, etc.).
  • Écrivez votre texte et répétez votre présentation pour être dans la durée demandée, car vous serez interrompus si vous dépassez.
  • Tout le monde assiste à toutes les présentations. Tout le monde arrive suffisamment en avance. Les consignes seront redonnées avant le début. Pas de rattrapage possible pour les retardataires qui rateraient leur créneau au début de la TH.
  • Si vous êtes deux sur un projet, vous avez le droit (mais ce n’est pas une obligation) de fusionner vos créneaux en un créneau unique de 4 minutes. Dans ce cas, contactez-nous. Dans ce cas, la présentation du projet peut être commune, mais il faudra que chacun présente sa contribution et son expérience.

Bon courage ☺

Trending Tags