You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
29 lines
1.5 KiB
29 lines
1.5 KiB
---
|
|
id: 4211
|
|
title: 'Architecture Decision Records: Réconciliez vous avec votre documentation'
|
|
language: Français
|
|
complexity: Débutant
|
|
tags:
|
|
- Method & Tools
|
|
presentation: >-
|
|
https://firebasestorage.googleapis.com/v0/b/devfesttoulouse-2018.appspot.com/o/presentation%2F4211-ArchitectureDecisionRecords-ArnaudBos.pdf?alt=media&token=20dac175-6460-4bd3-a490-544ceae883bb
|
|
videoId: EDYplU1PB5s
|
|
speakers:
|
|
- arnaud_bos
|
|
talkType: Quickie
|
|
|
|
---
|
|
|
|
Les développeurs aiment écrire de la documentation... ou pas !
|
|
Pourtant même les plus réfractaires doivent l'admettre, garder une trace des décisions techniques prises au cours d'un projet peut s'avérer indispensable pour la pérennité et maintenabilité de celui-ci.
|
|
|
|
Alors comment éviter l'obsolescence programmée de la documentation, tout en réduisant la pénibilité de la rédaction ?
|
|
|
|
Depuis près d'un an, dans "mon" équipe, nous utilisons un format simple, les Architecture Decision Records (ADRs), pour écrire des documents d'architecture sous la forme d'un journal immuable.
|
|
Cette technique simple gagne en popularité et a donné de bons résultats sur notre projet.
|
|
|
|
Durant cette présentation vous construirez en direct un ADR.
|
|
En partant d'un problème constaté sur un projet, vous élaborerez une réponse technique qui servira de base à une implémentation ultérieure.
|
|
Vous décrirez les raisons qui vous poussent à faire des compromis, tout en capturant le contexte dans lequel cette décision a été prise pour référence future.
|
|
|
|
Réconciliez vous avec votre documentation !
|
|
|