Une fonctionnalité nécessaire au contexte. J'ai ouvert le wiki.
La page datait de six mois. Il décrivait une architecture que nous avions reconstruite deux fois depuis. C’était faux, de haut en bas, et j’en étais sûr. Trois ingénieurs avaient déjà pris des décisions cette semaine-là sur cette base.
Personne n’a fait une erreur. La page vient d'être laissée pour compte par le code, comme ils le font tous.
Je l'ai donc supprimé. Ensuite, j’ai supprimé l’habitude qui persistait.
C'est la partie de Bodhiorchard, le workflow de développement open source que j'ai construit moi-même, sur laquelle je reçois le plus de réticences. Alors laissez-moi faire valoir mon point de vue. Y compris là où ça ne tient pas.
Vous ne l'avez tout simplement pas encore compris.
Cela commence honnêtement. Quelqu'un explique comment fonctionne le service de paiement, et ce jour-là, c'est parfait. Ensuite, le code bouge. Un champ est renommé. Un flux redirige. Un service se divise en deux.
Personne ne met à jour la page. Pas par paresse. La mise à jour de la page est l'affaire de tous, donc ce n'est l'affaire de personne.
Six mois plus tard, une nouvelle recrue le lit, le croit et envoie un bug.
À ce moment-là, le wiki n'est plus une documentation. C'est un musée sur la façon dont les choses fonctionnaient.
Nous avons tous discrètement souscrit au même accord : faites comme si le wiki était à jour, puis récupérez le code lorsque vous avez réellement besoin d'une réponse. Le grep est ...
[Courte citation de 8% de l'article original]