Première · Numérique et sciences informatiques

Découvrir la conception d'une application documentée : besoin, version, validation

Relier, sur un petit projet logiciel, un besoin exprimé à une version numérotée du code et à un test de validation, et justifier chaque lien dans la documentation du projet.

Aperçu gratuit

Les points essentiels

  • Un besoin décrit ce que l'utilisateur doit pouvoir faire, pas la manière de le programmer : il se formule par une phrase observable, par exemple « l'utilisateur peut ajouter une tâche à sa liste ».
  • Sans besoin écrit, on ne peut ni choisir les fonctionnalités à développer ni dire à quel moment l'application est terminée : la documentation commence donc par le besoin.

Les mots à connaître

Besoin
Capacité attendue de l'application, exprimée du point de vue de l'utilisateur et vérifiable. Exemple : « le programme affiche la moyenne d'une liste de notes ».
Version
État précis du code à un moment donné, identifié par un numéro ou un identifiant et accompagné d'une description des changements apportés depuis la version précédente.

Un exemple pour comprendre

Un élève veut une application qui calcule la moyenne d'une liste de notes saisies par l'utilisateur. Rédige le besoin, propose une version 0.1 et un test de validation avec la valeur attendue.

Besoin : « l'utilisateur fournit une liste de notes et le programme affiche leur moyenne ». Version 0.1 : une fonction moyenne(notes) qui renvoie la somme des notes divisée par leur nombre, sans interface. Note de version : « 0.1 : calcul de la moyenne, pas encore de saisie au clavier ». Test : entrée [10, 14, 12], résultat attendu 12, car 10 + 14 + 12 = 36 et 36 / 3 = 12. On exécute moyenne([10, 14, 12]) : si le résultat est 12, le test est réussi pour ce cas. La validation reste partielle : la liste vide n'est pas encore traitée.

Première page de l’Essentiel : Découvrir la conception d'une application documentée : besoin, version, validation
Ketty