« Nous accordons plus d'importance à un logiciel fonctionnel qu'à une documentation exhaustive. »
Bien que la documentation soit considérée comme importante, un logiciel fonctionnel est-il plus important ?
Le 4 décembre 2020, un petit-déjeuner en ligne sur le thème « La documentation en contexte Agile » a eu lieu. Compte tenu du contexte actuel, l'événement s'est déroulé en direct sur Microsoft Teams. Trente-trois participants, issus de secteurs d'activité variés et occupant différents rôles (Product Owner, Business Engineer, RE, etc.), ont répondu à l'invitation. Les intervenants ont partagé leurs connaissances et leur expérience sur le sujet, selon diverses perspectives décrites ci-dessous. Ils ont ensuite répondu aux questions des participants. Un enregistrement a été mis à disposition des personnes n'ayant pas pu assister à la session. Son contenu est brièvement présenté ci-dessous. Les références de l'enregistrement, disponibles auprès d'Infometis, y sont également indiquées.
Milica Trajkovic,
spécialiste en solutions d'affaires
L'une des quatre valeurs du Manifeste Agile stipule qu'un logiciel fonctionnel est plus précieux qu'une documentation exhaustive. Cependant, les deux extrêmes (absence de documentation versus documentation exhaustive) sont contre-productifs car ils ne permettent pas d'atteindre l'objectif de transmettre une compréhension du sujet . Il est donc recommandé d'utiliser la documentation comme un moyen d'atteindre un objectif et de la différencier d'autres canaux de communication, tels que la communication directe. La communication directe est particulièrement importante à l'ère de l'agilité et, grâce à des cycles courts de questions-réponses, les exigences peuvent être définies ou mises en œuvre plus clairement et plus rapidement. Par conséquent, une documentation détaillée n'est pas nécessaire pendant cette phase de discussion des exigences.
Les approches de la documentation dans un contexte agile sont les suivantes : la documentation doit être…
– axée sur les besoins et concise
– ne contenant que les détails nécessaires
– créée « juste à temps » pour éviter la documentation d'informations obsolètes
– réutilisée autant que possible à partir des ateliers, des schémas et des diagrammes
– facilement accessible au public cible
– élaborée de manière collaborative au sein de l'équipe.
Référence à la diffusion en direct :
Introduction de 00:08:39 à 00:20:16 ;
La documentation à l’ère agile de 00:12:16 à 00:20:25
Dr Patrick Steiger,
spécialiste des solutions d'affaires
Dans la continuité du sujet précédent, les contextes et les types de documentation ont été présentés. La question de savoir à qui s'adresse cette documentation a également été abordée. L'analyse du contexte évalue la communication et la collaboration, la maturité de l'équipe de développement agile, l'approche organisationnelle, le secteur d'activité et le type de développement. Il existe différents types de documentation qu'il convient de distinguer clairement. Au niveau le plus élevé, on distingue la documentation produit pérenne et la documentation des exigences à court terme. La documentation produit pérenne englobe la documentation fonctionnelle, technique et de test. La documentation des exigences à court terme est elle-même divisée en documentation de projet et en contenu d'implémentation. Concernant la documentation produit, la question de savoir à qui s'adresse cette documentation a reçu la réponse suivante : pour nous-mêmes, pour les développements futurs, pour l'utilisateur, pour l'exploitation et pour les révisions. La même question concernant la documentation des exigences peut être résolue comme suit : pour l'ensemble de l'équipe projet, le responsable produit, le client, les fournisseurs et les autres équipes, ainsi que les parties prenantes en général. [
Référence au direct :
Quelle documentation dans quel contexte ?]
de 00:20:37 à 00:38:19
Bernhard Fuchs,
génie de l'automatisation
La documentation a ensuite été examinée du point de vue d'un testeur et illustrée par des exemples pratiques. Pour les tests, la documentation est essentielle et doit être concise et visuelle, incluant des informations pertinentes telles que le résultat attendu et les données de test. Il est primordial qu'elle soit finalisée dans les délais impartis. Une documentation insuffisante a un impact significatif sur la mise en œuvre du projet, car les clarifications engendrent des pertes de temps supplémentaires et complexifient les tests. De plus, une documentation inadéquate peut rendre difficile la prise de contact avec certaines personnes. Concernant les types de documentation, du point de vue des tests, la conception conceptuelle des tests et les cas de tests de régression sont particulièrement importants pour une documentation durable. Pour la documentation des exigences, les concepts et les données de test, ainsi que des rapports de bogues et des rapports de test pertinents, sont essentiels. Les visualisations ou une cartographie des récits utilisateurs facilitent la compréhension de l'objet de test.
Voir la diffusion en direct
« Documentation agile du point de vue des tests »
de 00:38:20 à 00:54:00.
Anja Zhuchkova
Consultante Atlassian
Les outils de la suite Atlassian offrent un support de haut niveau pour la documentation agile. Confluence propose le plus grand nombre d'outils, car il a été conçu dès le départ pour simplifier la documentation et ainsi libérer du temps pour le développement. Selon nous, les fonctionnalités intégrées suivantes sont essentielles pour faciliter la documentation pour les employés :
– Bonnes pratiques prédéfinies et modèles personnalisés
– Édition et versionnage simultanés des pages
– Connexion bidirectionnelle avec Jira
– Retours rapides grâce aux commentaires et notifications intégrés
– Gestion simplifiée des permissions
– Extensions et options d'intégration variées (intégration Office, diagrammes, vidéos, etc.)
– Accès à distance via navigateur web et application mobile.
Outre Confluence, Jira offre également des outils importants qui facilitent la communication directe ainsi que la documentation produit et projet. Parmi ceux-ci figurent les notifications, les commentaires, les intégrations de gestion des tests et diverses fonctionnalités pour les cérémonies agiles.
Référence à la présentation en
des outils de documentation agile
de 00:54:06 à 01:09:00.
Session de questions-réponses à partir de 01:10:00.
Comme on peut le constater, le sujet complexe du documentaire a été présenté sous différents angles et avec une expertise approfondie.
Vous avez besoin d'aide pour élaborer une stratégie de documentation ? N'hésitez pas à contacter Patrick Steiger ou Milica Trajkovic. Nous proposons une formation en entreprise adaptée à votre contexte et nous élaborerons ensemble la stratégie la plus appropriée grâce à des ateliers.
Voici quelques aperçus de ce qui s'est passé en coulisses lors de cet événement Teams Live :
