Écrivez vos états d'erreur pour un étranger dans trois mois, pas pour vous-même aujourd'hui

La plupart des messages d'erreur sont écrits pour le mauvais lecteur.

Ils sont écrits pour la personne qui regarde quand la chose se brise. Vous êtes au terminal, l'exécution échoue, le message ditConnexion rejetéeoula validation a échoué à l'étape 3, et ça suffit, car vous avez tout le contexte en tête en ce moment. Vous savez ce que vous faisiez, ce que vous avez changé, ce que le système était censé faire. Le message doit simplement rafraîchir un souvenir que vous possédez déjà.

Le lecteur qui a réellement besoin de l’état d’erreur est quelqu’un d’autre, et il apparaît des mois plus tard. J'ai parlé de ce point de vue dans un long fil de commentaires sur un article précédent, et cela a changé ma façon de penser la gestion des échecs, en particulier pour le travail asynchrone piloté par agent que je fais beaucoup maintenant.

Le lecteur pour lequel vous ne concevez pas

Voici l'écart. Lorsqu'un outil inte...
[Courte citation de 8% de l'article original]