DÉCISIONS / JOURNAL D’ARCHITECTURE

Ce que j’ai tranché,
et ce que ça coûte.

Une décision d’architecture ne se juge pas sur son résultat mais sur ce qu’elle a pesé. Chaque entrée porte donc le problème réel, les options sérieusement envisagées, ce qui les a disqualifiées, le compromis accepté, et ce que la décision a changé dans le code. Une décision revenue reste en ligne, datée, et pointe vers celle qui la remplace.

ÉTAT DU JOURNAL0

décision publiée, dont 0 en vigueur et 0 sur laquelle je suis revenu.

Voir les revirements ↗

LE JOURNAL

Aucune décision servie.

Le journal est vide, injoignable, ou ses entrées attendent d’être relues. Rien n’est affiché en attendant : une décision d’architecture affirme des choses sur mon propre travail, et elle ne se publie pas avant que je l’aie relue.

Voir les principes qui en sont dérivés

COMMENT LIRE UNE LIGNE

AcceptéeEn vigueur aujourd’hui.

RemplacéeUne décision ultérieure l’a remplacée. Elle reste en ligne et pointe vers celle qui la remplace. Revenir sur une décision est ici une qualité, pas un aveu.

RéversibilitéLe coût du retour en arrière, du plus simple au plus lourd. Une décision difficilement réversible se prend plus lentement.

ReconstruiteL’entrée a été rédigée après coup, à partir du dépôt. Les options listées sont celles que le code démontre, elles ne prétendent pas décrire ce qui a été envisagé à l’époque.

CE QUI EN DÉCOULE

Des principes, pas un manifeste.

Cinq règles, chacune dérivée d’une décision ou d’une erreur réelle, et chacune avec le prix qu’elle fait payer.

Lire les principes