Qu'est-ce que la documentation agile a en commun avec la cuisine ?

Mon client m'appelle et me dit : « Nous sommes agiles maintenant – nous n'avons plus besoin de documentation ! » Je reste planté devant mon téléphone, abasourdi, et je pense : « En fait, il a raison. ».

Le soir, je retrouve une amie pour cuisiner. Au menu : rösti et salade. Elle me demande de préparer les pommes de terre pour les rösti pendant qu’elle s’occupe de la vinaigrette. Quand les pommes de terre sont prêtes, elle découvre avec horreur que je les ai épluchées avant de les cuire. « C’est tellement plus pratique et rapide », me dis-je. Après dix minutes à râper en vain – le résultat ressemble à de la purée –, je me résous à faire bouillir les pommes de terre une seconde fois, cette fois avec la peau. Pendant qu’elle prépare le dessert, je fais frire les rösti et je les assaisonne. Elle me demande le mélange d’épices. Le seul problème, c’est que je ne me souviens plus exactement des ingrédients.

À ce moment précis, j'ai eu une révélation : même si nous travaillons désormais en mode agile, la documentation (la recette) facilite la communication, et la documentation produit (la documentation du mélange d'épices) est cruciale pour l'avenir de notre produit. On pourrait objecter que, comme dans les projets agiles, nous avons rapidement identifié et corrigé notre erreur. Mais si nous nous étions
appuyés sur une recette pour communiquer, cette erreur ne se serait jamais produite. Et si j'avais documenté le mélange d'épices pendant que je préparais le rösti, nous aurions pu partir de là la prochaine fois et peut-être même l'améliorer.

Que faut-il donc documenter et comment ?

Dans un contexte agile, les principes ont considérablement changé par rapport aux projets traditionnels !

Nous ne documentons que le strict nécessaire et le moins possible.

Nous ne documentons plus pour le simple plaisir de documenter, mais parce que la documentation est bénéfique et favorise la communication entre les différentes parties.

Et nous créons la documentation «juste à temps».

Il n'existe probablement pas de format de documentation agile unique, mais plutôt des outils plus ou moins adaptés à la situation actuelle.

Par exemple, lors de la phase initiale d'un projet agile, il est utile de créer une carte des récits utilisateurs au niveau de l'épopée (planification des menus). Toutefois,
l'utilisation d'un diagramme de contexte ou d'un diagramme de classes reste pertinente si elle facilite la communication.

Les user stories servent désormais à décrire les exigences individuelles. Leur principal avantage réside dans le fait qu'elles mettent l'accent sur les bénéfices pour le client plutôt que sur la solution elle-même. Toutefois, si les bénéfices pour le client ne sont pas négligés et que l'équipe juge cette approche plus efficace, les exigences peuvent toujours être formulées à l'aide d'un modèle de phrase.

Pour discuter de processus ou de problèmes détaillés, des « recettes » comme les wireframes, BPMN ou le développement piloté par le comportement (scénarios basés sur des règles métier) sont appropriées. Mais les cas d'utilisation 2.0 (un cas d'utilisation en constante évolution) ou les diagrammes d'activité UML sont également des outils efficaces. Tout comme en cuisine, ce n'est pas tant l'outil utilisé qui importe, mais le résultat obtenu. Peu importe que je monte les blancs d'œufs au fouet ou au robot culinaire. Ce qui compte, c'est ma maîtrise de l'outil et le résultat obtenu. La documentation agile est donc un peu comme la cuisine : on ne cuisine pas pour le simple plaisir de cuisiner, mais pour créer de la valeur à travers le contenu.

Pour garantir le succès de notre menu, nous utilisons le bon matériel de cuisine (outils) au bon moment (juste à temps) et utilisons autant d'ingrédients que nécessaire et aussi peu que possible.

Et lorsque nous adaptons une recette, nous documentons la modification afin de pouvoir la réutiliser ultérieurement. En respectant ces principes, la documentation en contexte agile sera également couronnée de succès.

Gabriela Meier

Cela pourrait également vous intéresser : S’orienter dans la jungle des méthodes avec Whirl of Methods

Vous souhaitez apprendre les bases de l'immobilier ou rafraîchir vos connaissances ? Nous vous invitons cordialement à rejoindre notre Académie.

Ou préférez-vous une formation sur mesure pour votre équipe ? Dans ce cas, contactez-nous.