Rendre visibles tes artefacts
Une bonne démonstration ne se limite pas à montrer l’application qui tourne. L’enseignant et le client doivent aussi pouvoir voir comment vous avez organisé votre travail et documenté votre projet.
Cette page t’aide à vérifier que tes principaux artefacts (Jira, GitHub, dossier de conception, stratégie de tests) sont à jour, cohérents avec ce que tu présentes, et facilement accessibles au moment de la revue du sprint 1.
Jira : backlog et sprint visibles
Jira doit refléter ce que vous avez réellement fait pendant le sprint, pas seulement ce que vous aviez prévu au départ.
- Vérifie que le sprint 1 contient bien les stories sur lesquelles vous avez travaillé (et pas des stories obsolètes ou abandonnées).
- Mets à jour l’état des stories et des tâches (terminé, en cours, à faire) en fonction de la réalité actuelle.
- Assure-toi que les descriptions et les critères d’acceptation des stories importantes sont suffisamment clairs pour quelqu’un qui lit Jira pendant la revue.
- Garde une trace des décisions importantes ou des changements de plan sous forme de commentaires sur les issues concernées.
GitHub : code et structure du dépôt
Le dépôt GitHub sert de référence pour ton code et ta documentation. Il doit donner une image fidèle de l’état du projet à la fin du sprint 1.
- Vérifie que toutes les branches importantes ont été fusionnées ou, au minimum, poussées sur GitHub et clairement identifiées.
- Assure-toi que la structure du dépôt est en place (
src/,docs/,tests/, etc.) et qu’elle correspond à ce que vous avez présenté dans le cours. - Confirme que le code compile (ou s’exécute) à partir de la branche principale que vous allez utiliser pour la démo.
- Vérifie que les fichiers importants (documentation, scripts, configuration de base) sont présents et bien rangés.
Dossier de conception : refléter l’état du projet
Le dossier de conception doit correspondre à ce que vous avez effectivement mis en place dans le sprint 1, même s’il n’est pas complet.
- Mets à jour les diagrammes qui concernent les fonctionnalités livrées (cas d’utilisation, classes, séquences, objets, etc. selon ce que vous avez fait).
- Ajoute, si nécessaire, quelques précisions sur l’architecture réellement implantée (si elle a évolué depuis les premières idées).
- Vérifie que les fichiers du dossier de conception sont bien dans
docs/et faciles à ouvrir pendant la revue. - Fais le lien, dans le texte ou les titres, entre certains diagrammes et les fonctionnalités que tu vas démontrer.
Stratégie de tests et tests unitaires
Ta stratégie de tests et tes tests unitaires sont une partie importante de la qualité de ton projet, même si tout n’est pas encore couvert.
- Relis ton document de stratégie de tests pour t’assurer qu’il couvre au moins les fonctionnalités livrées dans le sprint 1.
- Vérifie que certains scénarios décrits dans la stratégie sont effectivement implémentés sous forme de tests unitaires.
- Assure-toi que les tests unitaires peuvent être exécutés facilement (et idéalement qu’ils passent) pour pouvoir le montrer ou le mentionner pendant la revue.
- Mets à jour le document si des décisions importantes ont été prises concernant ce qui est testé ou non.
Accessibilité pour l’enseignant et le client
Tous ces artefacts ne servent à rien s’ils ne sont pas accessibles au moment de la revue de sprint.
- Vérifie que l’enseignant a toujours accès à votre projet Jira avec les bons droits.
- Vérifie que l’enseignant a accès à votre dépôt GitHub privé (ajout comme collaborateur avec les droits nécessaires).
- Prépare une courte liste de liens utiles (Jira, GitHub, dossier de conception, stratégie de tests) que tu pourras partager ou utiliser pendant la présentation.
Ce que ton équipe devrait avoir préparé
- Un projet Jira à jour, qui reflète fidèlement l’état du sprint 1 (stories, tâches, commentaires).
- Un dépôt GitHub propre, avec la bonne structure et un code qui représente l’état livré pour le sprint 1.
- Un dossier de conception et une stratégie de tests mis à jour pour les fonctionnalités que vous allez démontrer.
- Des liens vérifiés vers tous ces artefacts, pour pouvoir les consulter facilement pendant la revue.