La documentation technique n'est pas une corvée : modèle mental pour documenter efficacement (fr)

Un retour d’expérience sur les pièges classiques de la documentation technique : le README obsolète, les docstrings inutiles et le “théâtre de la documentation”. L’article propose un cadre de décision basé sur le ROI pour distinguer quatre types de docs, du ROI infini (doc fonctionnelle) au ROI négatif (doc d’implémentation). L’objectif : documenter le “pourquoi” plutôt que le “comment”, en laissant au code propre le soin de décrire l’implémentation.