👀 Je lisais la documentation @BabylonLabs_io , en me disant que j’allais juste comprendre comment tout fonctionne.
Puis je suis tombé sur les commentaires “divers”… et d’une façon ou d’une autre, ces petites notes se sont retrouvées être la partie la plus intéressante. 😂
Du genre : d’accord… les commentaires que les gens écrivent « juste pour maintenant » révèlent parfois plus sur un système que la documentation soignée.

Voici ce que ce type d’audit met vraiment en évidence :
Dette technique cachée Les commentaires « TODO : corriger ça plus tard » qui n’ont jamais été traités. Quelqu’un l’a vu, quelqu’un est passé à autre chose.
Préoccupations de maintenabilité Les notes que les développeurs laissent à leur futur eux (ou à un futur quelqu’un d’autre) concernant des portions fragiles ou difficiles à modifier.
Indicateurs de risque futur Des commentaires “au passage” qui signalent des hypothèses qui ne tiennent que pour le moment : ce qui deviendra silencieusement un problème plus tard.
Points de friction d’architecture Quand les composants ne s’emboîtent pas tout à fait proprement, et que quelqu’un a laissé un commentaire au lieu d’une correction.

En gros : le “divers” n’est pas vraiment du divers. C’est le journal d’ingénierie que personne ne lit.
#baby $BABY