Formations — 1 037 leçons en français

Accueil › Architecture & design patterns › Documenter les décisions

Documenter les décisions — entretien Architecture & design patterns

12 questions posées en entretien sur 8 sujets, avec la bonne réponse et son explication.

Décision écrite

Qu'est-ce qu'une décision d'architecture écrite consigne avant tout ?

  1. Un arbitrage : la contrainte, les options comparées, le choix et son prix ✓
  2. La description à jour des composants du système
  3. Le plan de mise en œuvre et son calendrier
  4. Les conventions de nommage adoptées par l'équipe

Pourquoi : Le document explique comment l'architecture est devenue celle-là, pas à quoi elle ressemble aujourd'hui. Une description vieillit à chaque livraison et personne ne la met à jour ; un arbitrage daté reste vrai pour toujours. Ce qui distingue une bonne réponse, c'est d'ajouter que le plan de mise en œuvre est justement ce qu'on n'y met pas.

Niveau junior

Registre

Où range-t-on le registre de décisions ?

  1. Dans le dépôt, versionné avec le code qu'il explique ✓
  2. Dans l'outil de gestion de projet, à côté des tickets
  3. Sur un espace partagé accessible à toute l'entreprise
  4. Dans le fichier README du projet, en une section unique

Pourquoi : Le registre suit les branches, apparaît en revue et se lit à la version du code consulté. Un espace séparé diverge, parce que rien n'oblige à l'ouvrir quand on modifie le code. Une section unique de README ne permet ni la numérotation stable ni la lecture chronologique qui font l'intérêt du registre.

Niveau junior

Format

Quelles sections forment le cœur d'une décision écrite ?

  1. Contexte, options considérées, décision, conséquences ✓
  2. Objectifs, périmètre, planning, budget
  3. Résumé, schéma, annexes techniques
  4. Besoin, spécification, critères de recette

Pourquoi : Chaque section fait un travail : le contexte nomme la pression, les options prouvent qu'il y a eu arbitrage, la décision tranche, les conséquences nomment le prix. Un périmètre ou un budget relèvent du pilotage de projet, pas de la trace d'un choix technique. La bonne réponse précise aussi qu'un statut et un numéro encadrent l'ensemble.

Niveau junior

Pourquoi un titre de décision s'écrit-il à la forme affirmative ?

  1. Le sommaire du registre devient lisible sans ouvrir les fichiers ✓
  2. Les moteurs de recherche indexent mieux les verbes
  3. Le format impose grammaticalement un verbe conjugué
  4. Cela évite d'avoir à renseigner le statut

Pourquoi : Un registre se consulte d'abord par sa liste. « Format des messages » oblige à ouvrir le document ; « Publier les événements en JSON » répond tout de suite. L'erreur fréquente consiste à nommer la décision comme un chapitre de documentation, ce qui annule le principal gain du format.

Niveau junior

Cycle de vie

Que fait-on d'une décision dont le choix n'est plus appliqué ?

  1. On la marque « remplacée par N » et on garde son texte intact ✓
  2. On corrige son contenu pour qu'il décrive le nouveau choix
  3. On la supprime du dépôt, puisqu'elle est fausse
  4. On la déplace dans un répertoire d'archives non versionné

Pourquoi : Le registre n'est pas un état, c'est un chemin. Une décision remplacée montre qu'une solution a été essayée et pourquoi on en est revenu — exactement l'information qui empêche de la réessayer. La modifier détruit cette information en laissant croire que l'équipe a eu raison du premier coup.

Niveau junior

Pourquoi interdire la modification d'une décision acceptée ?

  1. Le registre perdrait sa capacité à montrer le chemin parcouru et les changements d'avis ✓
  2. Les fichiers Markdown ne supportent pas les modifications partielles
  3. La numérotation deviendrait invalide
  4. Le contrôle de version empêche techniquement la modification

Pourquoi : Un texte modifiable ne montre que la dernière version, ce qui laisse croire que l'équipe a eu raison du premier coup — et interdit d'apprendre quoi que ce soit. Rien ne l'empêche techniquement, c'est une discipline. La bonne réponse distingue la correction d'une faute de frappe, admise, du changement de fond, qui exige une nouvelle décision.

Niveau senior

À quoi sert un déclencheur de réexamen inscrit dans une décision ?

  1. Il rend la révision prévue, donc discutable sans mettre en cause l'auteur ✓
  2. Il fait expirer la décision automatiquement à la date indiquée
  3. Il dispense d'écrire la section des conséquences
  4. Il transfère la responsabilité du choix à l'équipe suivante

Pourquoi : Rouvrir une décision ressemble à un reproche adressé à son auteur, souvent encore présent, et ce coût social bloque la discussion plus sûrement qu'un argument technique. Une condition vérifiable écrite à l'avance la transforme en événement attendu. Elle n'automatise rien : quelqu'un doit constater que la condition est remplie.

Niveau senior

Périmètre

Quel critère décide qu'un choix mérite une décision écrite ?

  1. Le coût du retour arrière six mois plus tard ✓
  2. Le nombre de fichiers modifiés par le changement
  3. Le fait que le choix ait été discuté en réunion
  4. Le niveau hiérarchique de la personne qui tranche

Pourquoi : Le volume de code n'indique rien : une ligne de configuration peut lier l'entreprise à un fournisseur pour des années, tandis qu'un renommage massif se défait en une commande. Ce qui distingue une bonne réponse, c'est de citer le cas trompeur — la décision minuscule en lignes et énorme en engagement.

Niveau confirme

Contexte

Lequel de ces contextes est réellement exploitable deux ans plus tard ?

  1. « La facturation est arrêtée quatre heures par mois ; la prise de commande échoue alors » ✓
  2. « Notre système comprend trois services et une base PostgreSQL »
  3. « Le système doit être performant et maintenable »
  4. « L'architecte a recommandé cette approche »

Pourquoi : Un contexte utile nomme une pression datée et vérifiable, pas l'état du système ni un objectif intemporel. Le test consiste à retirer la phrase et à voir si la décision reste évidente ; si oui, la phrase ne servait à rien. Citer une personne au lieu d'un argument rend par ailleurs toute révision conflictuelle.

Niveau confirme

Une boucle fait un appel par identifiant parce que le fournisseur n'acceptait qu'un identifiant à la fois. Le fournisseur propose désormais des lots. Qu'est-ce qui manque ?

  1. La trace écrite et datée de la contrainte, qui permettrait de constater sa disparition ✓
  2. Un test de performance sur la boucle
  3. Un commentaire expliquant le fonctionnement de la boucle
  4. Une revue de code sur le module concerné

Pourquoi : Sans contrainte datée, deux attitudes se partagent l'équipe : la superstition, qui n'y touche pas, et le culte du cargo, qui recopie le motif ailleurs. Un commentaire sur le fonctionnement n'aide pas ; ce qu'il faut, c'est la raison et sa date, pour vérifier si elle tient encore.

Niveau confirme

Conséquences

Une section « conséquences » ne liste que des bénéfices. Qu'est-ce que cela signale ?

  1. La décision n'a pas été comprise, ou le document est une plaidoirie ✓
  2. La décision est particulièrement bien choisie
  3. Les conséquences négatives relèvent d'un autre document
  4. Le format exige de séparer coûts et bénéfices

Pourquoi : Toute décision structurante rend quelque chose de plus difficile. Les bénéfices sont déjà portés par le contexte et par le choix lui-même ; la section sert à loger le prix accepté. Non écrit, ce prix sera redécouvert plus tard comme un bogue, et quelqu'un passera une semaine à corriger un comportement voulu.

Niveau confirme

Options

Une décision présente deux options, dont l'une est manifestement absurde. Que faut-il en conclure ?

  1. Aucun arbitrage n'a eu lieu : la seconde option est un figurant ✓
  2. L'auteur a été exhaustif dans son étude
  3. La décision est particulièrement solide
  4. Il manque simplement une troisième option

Pourquoi : Un épouvantail ne prouve rien et trahit un document rédigé après coup pour justifier un choix déjà fait. S'il n'existait réellement aucune alternative, il faut l'écrire — « contrainte réglementaire, aucune option viable » est une information utile. La bonne réponse ajoute que l'absence d'arbitrage n'est pas un défaut si elle est assumée.

Niveau confirme

S'entraîner sur ces questions, chronométré →