Les termes de la décision

Prévoir rédaction, vérification et mise à jour dans chaque changement significatif.

Une documentation abondante mais obsolète peut être plus dangereuse qu’une limite clairement signalée.

Conserver la justification, l’autorité de décision et la condition de réexamen. Une exception doit être compréhensible par une personne qui n’a pas participé à l’arbitrage.

Elle réduit la dépendance aux personnes clés et accélère le diagnostic ou la transmission.

Application à votre contexte

Tracez les options écartées et les hypothèses qui font pencher la décision. Une exception doit avoir un périmètre, un approbateur et une condition de réexamen, faute de quoi elle devient une règle implicite.

Comparez la complexité totale, et non seulement la sophistication technique. Une solution distribuée apporte des possibilités mais aussi des pannes partielles et des exigences d'exploitation. Choisissez une architecture que les équipes peuvent livrer, comprendre et faire évoluer.

Remettre cette réponse dans son contexteDocumentation technique et exploitabilité

Références pour approfondir