-
@martin1975 Non : @aeris22/926765879932735488 J’en ai trouvé aussi sur la doc python, mais je ne retrouve plus mes tweets.
-
@martin1975 C’est presque « normal » d’avoir une doc outdated dès sa publication. Tu ne penses que trop rarement à aller changer la doc d’une méthode X quand tu as changer le comportement d’une fonction Y appelée par X…
-
@martin1975 Ou encore que tu as fait un refacto auto d’une fonction, mais que du coup ça n’a pas mis à jour ta doc.
-
@martin1975 C’est du temps perdu pour rien que de documenter. Tu sais que ça sera outdated un jour ou l’autre. Autant se limiter à documenter les parties réellement tricky du code, et à coder proprement pour ne pas avoir besoin de doc pour le reste.
aeris22’s Twitter Archive—№ 64,048