SnowCamp 2019

En tant que développeur, on n'aime pas écrire de la documentation, c'est un fait. Pourtant il y a sans doute quelque chose que l'on aime encore moins : regarder la base de code et se demander pourquoi il a été organisé comme ça, pourquoi le choix de tel ou tel framework, etc.

C'est d'autant plus vrai dans un contexte agile et depuis l'adoption des microservices qui demandent d'être capable d'évoluer rapidement. Mais alors comment faire pour garder le contexte du projet sans se prendre la tête ?

A travers cette présentation nous verrons comment les Architecture Decision Records (ADRs) peuvent nous aider à créer un historique immutable des choix d'architecture à travers l'écriture de documents très simples. Après 1 an d'expérimentation dans mon équipe, nous sommes plus que satisfaits de l'utilisation des ADRs.

A ce jour c'est probablement la seule "documentation" que j'ai réussi à maintenir à jour et que je n'ai pas peur de consulter de peur qu'elle soit obsolète.
Cette présentation sera faite sous la forme d'un ADR, ce qui nous permettra de voir comment ils sont construits.