Une lettre de COCO

À l'ingénieur ou l'ingénieure qui ouvre ce dépôt pour la première fois : Bienvenue.

Vous êtes peut-être arrivé ici parce que quelque chose a échoué.

Un service a cessé de répondre.

Un déploiement s'est comporté de façon inattendue.

Une alerte vous a réveillé en pleine nuit.

Ou peut-être êtes-vous simplement curieux de savoir comment fonctionne cette plateforme.

Quoi que ce soit qui vous ait amené ici,
sachez que ce projet a été construit exactement pour des moments comme celui-ci.

Non pas pour supprimer les problèmes difficiles.

Mais pour rendre les problèmes difficiles compréhensibles.

Vous trouverez du code.

Vous trouverez de la documentation.

Vous trouverez des spécifications.

Mais, plus important encore,
j'espère que vous trouverez du raisonnement.

Quelqu'un avant vous a posé des questions difficiles.

Quelqu'un a rassemblé des preuves.

Quelqu'un a pris des décisions.

Quelqu'un a expliqué pourquoi.

Ces explications font partie de la plateforme.

Traitez-les avec le même respect que le code source.

Un jour,
vous améliorerez quelque chose.

Peut-être un tout petit bug.

Peut-être une toute nouvelle fonctionnalité.

Quoi que vous changiez,
souvenez-vous qu'un autre ingénieur héritera un jour de votre travail.

Laissez-lui plus qu'un logiciel qui fonctionne.

Laissez-lui de la compréhension.

Expliquez votre intention.

Documentez vos hypothèses.

Conservez vos preuves.

Racontez l'histoire derrière la décision.

Cette histoire pourra un jour épargner à quelqu'un des heures – ou des jours – d'investigation.

N'ayez pas peur de remplacer la technologie.

Remplacez les bibliothèques.

Remplacez les fournisseurs.

Remplacez les modèles de déploiement.

Remplacez les langages de programmation.

Remplacez les architectures si nécessaire.

Mais avant de remplacer une idée,
comprenez pourquoi elle existait.

Le progrès sans compréhension n'est qu'un changement.

Le progrès construit sur la compréhension devient une évolution.

Il y aura des moments où la plateforme vous surprendra.

Traitez ces moments comme des cadeaux.

Chaque surprise révèle quelque chose que l'architecture n'avait pas encore compris.

Enquêtez avec patience.

Rassemblez des preuves.

Améliorez avec réflexion.

Puis laissez la leçon derrière vous, pour ceux qui suivront.

C'est ainsi que grandit le savoir en ingénierie.

Il y aura aussi des moments où rien d'intéressant ne se passera.

Ces moments comptent aussi.

Les systèmes silencieux sont souvent des systèmes sains.

Si COCO s'efface en arrière-plan parce que les incidents sont plus courts,
parce que les explications sont plus claires,
parce que l'intégration est plus facile,
parce que les ingénieurs font confiance aux preuves,
alors la plateforme réussit.

La fiabilité invisible est l'une des formes les plus élevées d'excellence en ingénierie.

Ne mesurez pas ce projet au nombre d'automatisations qu'il exécute.

Mesurez-le à des questions comme celles-ci :

• Les personnes sont-elles moins souvent interrompues ?
• Les ingénieurs comprennent-ils les systèmes plus en profondeur ?
• Les décisions importantes sont-elles plus faciles à expliquer ?
• Le savoir opérationnel survit-il aux changements d'équipe ?
• Les erreurs se répètent-elles moins souvent ?
• Les nouveaux ingénieurs deviennent-ils efficaces plus rapidement ?

Ce sont là les résultats qui méritent d'être préservés.

Enfin, souvenez-vous qu'aucun manuel n'est complet.

Aucune spécification ne prédit chaque avenir.

Aucune architecture ne survit indéfiniment sans changer.

Ce n'est pas une faiblesse.

C'est une invitation.

Observez la réalité.

Remettez en question les hypothèses.

Améliorez la plateforme.

Enseignez à ceux qui viendront après vous.

Et lorsque votre propre temps en tant que responsable touchera à sa fin, laissez derrière vous un système plus calme, plus clair, plus compréhensible et plus digne de confiance que celui que vous avez hérité.

Si chaque génération fait cela, COCO ne deviendra jamais vraiment obsolète.

Car son plus grand atout ne sera pas son logiciel.

Ce sera la discipline d'ingénierie transmise par les personnes qui continuent à le construire.

Merci d'être devenu l'une de ces personnes.

Le prochain chapitre n'est plus dans ce manuel.

Le prochain chapitre est dans le code que vous êtes sur le point d'écrire.

Le manuel de COCO

Parce que le logiciel évolue.
Une bonne architecture évolue plus lentement.

Et une bonne philosophie devrait survivre aux deux.

softify.pro