Utiliser la gestion de versions (Git) pour valider un besoin dans une application documentée
Utiliser un outil de gestion de versions (commits, branches, historique) pour faire évoluer une application Python documentée et relier chaque version à un besoin validé par un test.

Les points essentiels
- Une version est un état identifiable du projet : un commit enregistre un instantané du code et de la documentation avec un message qui explique le pourquoi du changement.
- Le besoin exprimé par l'utilisateur ou le client guide les versions : chaque évolution significative répond à un besoin précis, formulé en une phrase vérifiable.
Les mots à connaître
- Version
- État du projet à un instant donné, enregistré et identifiable dans l'historique (par exemple un commit ou un tag comme v1.0), que l'on peut retrouver et comparer.
- Validation
- Vérification qu'une version satisfait le besoin exprimé, par des tests, des scénarios d'utilisation et une documentation à jour.
Un exemple pour comprendre
Un projet contient une fonction moyenne(notes) qui renvoie la somme des notes divisée par leur nombre. Le besoin devient : « gérer une liste vide sans planter ». Décrivez la démarche avec les versions, du premier commit jusqu'à la validation.
1) Le commit initial (« Ajout de moyenne ») enregistre la version 1. 2) On constate que moyenne([]) provoque une ZeroDivisionError : le besoin n'est pas satisfait. 3) On crée une branche gestion-liste-vide. 4) On modifie la fonction : si la liste est vide, elle renvoie None. 5) On valide avec des tests : assert moyenne([10, 20]) == 15 et assert moyenne([]) is None. 6) On met à jour la docstring (« renvoie None si la liste est vide »). 7) On commite avec le message « Gère la liste vide dans moyenne », puis on fusionne dans la branche principale. L'historique montre ainsi clairement quel commit répond à quel besoin.

