Le transfert de connaissances reste un défi majeur dans le développement logiciel, en particulier sur le long terme et face au turnover des équipes. L'approche Living Documentation (Documentation Vivante) est une solution efficace et attractive pour maximiser le transfert et la conservation du savoir sans devenir une charge de travail élevée pour les membres de l'équipe.
Aujourd'hui, cette approche prend une dimension nouvelle : les pratiques de Living Documentation sont devenues essentielles pour travailler efficacement avec l'IA. En structurant le code et la connaissance de manière explicite et contextuelle, vous optimisez à la fois la collaboration humaine et l'efficacité des assistants IA (Copilot, Claude, Cursor etc.).
Au cours de cette formation, les participantes et les participants comprendront comment cette approche bouleverse la gestion des connaissances traditionnelles, découvriront les pratiques essentielles en théorie et par une mise en pratique, apprendront que la documentation est aussi un outil de feedback rapide et découvriront des moyens d'introduire cette approche dans leur environnement. Cette approche permet également d'accélérer les rythmes de développement et des changements visés en Continuous Delivery, DevOps et toutes les approches Agiles.
- Revisiter la gestion de connaissances : hiérarchiser ce qui mérite ou non d'être formalisé, et comment formaliser par des moyens économes dans la durée
- Apprendre à augmenter le code pour le rendre plus explicite
- Générer un Living Diagram directement à partir du code, avec ou sans IA
- Générer un Glossaire Vivant directement à partir du code
- Pratiquer les Architectural Decision Records
- Comprendre comment l'IA aide à pratiquer la living documentation, qui a son tour aide l'IA
- Identifier les Shameful Comments, et rendre visible les travers de votre modèle métier
- Réaliser que les Design Patterns aident à documenter des décisions
- Améliorer le système et apprendre à introduire cette approche
Vous êtes développeuse ou développeur, architecte, team lead, testeuse ou testeur, sachant coder ou bien coach ? Cette formation est pour vous !
Tous les exemples seront en Java (un poste de travail avec un IDE Java et Maven installé est requis), mais sont facilement extrapolables à d’autres univers, en particulier .Net ou typescript, et d'autant plus facilement avec un coding assistant.
Avoir un minimum d’expérience dans la conception logicielle dans le cadre de projets d’entreprise.
Pour chaque formation, un quiz de validation des prérequis sera transmis 2 semaines en amont, et un autre en fin de session pour valider les acquis.
Les formateurs distribueront les supports de la formation au format électronique PDF à la fin de la formation. Tous les exemples seront en Java (un poste de travail avec un IDE Java et Maven installé est requis), mais sont facilement extrapolables à d’autres univers, en particulier .Net ou typescript, et d'autant plus facilement avec un coding assistant.
Cette approche est décrite en détail dans le livre « Living Documentation » (ISBN-13: 978-0134689326) annoncé chez Addison-Wesley Professionals, écrit par Cyrille Martraire, co-fondateur d'Arolla.
La formation est donnée en français ou en anglais. Les supports de formation sont en anglais. Pour chaque formation, un quiz de validation des prérequis sera transmis 2 semaines en amont, et un autre en fin de session pour valider les acquis
CTO associé Arolla
Formatrice et CTO Arolla
Senior software craft engineer
Banque et services
Banque et assurance
Retail (grande distribution)
Banque et assurance
Retail (grande distribution)
L'intérêt de l'approche Living Documentation (Documentation Vivante) est d'être une solution efficace et attractive pour maximiser le transfert et la conservation du savoir sans que cela ne devienne une charge de travail élevée pour les membres de l'équipe
Métriques essentielles en développement logiciel, notamment l'analyse de code et les métriques DORA (DevOps Research and Assessment).
Cette formation sera l’occasion d'apprendre les techniques et pratiques pour utiliser l’IA générative de façon effective en développement logiciel. L'IA est un amplificateur qui, sans discipline technique, peut accélérer la Dette Technique et amplifier la duplication du code de mauvaise qualité. Cette formation dépasse le simple Prompt Engineering pour vous transmettre les compétences de Context Engineering : comprendre comment l'IA fonctionne réellement, structurer vos interactions pour obtenir des résultats fiables, et mettre en place des garde-fous pérennes