Architecture Decision Records : enfin une documentation qui vous ressemble !

GDG Bordeaux

Pour cette session, Olivier Revial viendra nous parler d'ADR. Vous aimez écrire de la doc ? Pas moi. On a pourtant tous besoin de conserver un historique des décisions prises sur un projet... Dans ce talk, venez découvrir les ADRs et apprenez à garder une trace de tous vos choix d'architecture et de design sans vous prendre la tête ! En tant que développeur, on n'aime pas écrire de la documenta

Apr 23, 2019, 5:00 – 7:00 PM (UTC)

0 RSVP'd

Key Themes

About this event

Pour cette session, Olivier Revial viendra nous parler d'ADR.

Vous aimez écrire de la doc ? Pas moi. On a pourtant tous besoin de conserver un historique des décisions prises sur un projet... Dans ce talk, venez découvrir les ADRs et apprenez à garder une trace de tous vos choix d'architecture et de design sans vous prendre la tête !
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.

Nous terminerons la soirée autour d'un apéro participatif (comprendre : n'hésitez pas à ramener à boire et/ou à manger) !

Organizers

  • sebastien descamps

    Organizer

  • Enzo Conty

    AppLoops

    Organizer

Contact Us