À partir du moment où tu as la nécessité de documenter ton code parce qu'il n'est pas compréhensible, pourquoi ne pas plutôt le refactorer pour le rendre justement compréhensible sans doc ?
La documentation n'est pas réservée au code « incompréhensible », elle sert à éviter d'avoir à lire le code, que celui-ci soit compréhensible ou non. Évidemment, cela prend tout son intérêt quand tu écris des bibliothèques de plus de vingt lignes, et encore plus si d'autres développeurs utilisent ton code.
(les déclarations de typage que tu défends sont aussi une forme de documentation, mais cela n'a pas l'air de t'effleurer l'esprit)
[^] # Re: Le titre est trop long
Posté par Antoine . En réponse au journal Typage statique versus typage dynamique. Évalué à 3.
La documentation n'est pas réservée au code « incompréhensible », elle sert à éviter d'avoir à lire le code, que celui-ci soit compréhensible ou non. Évidemment, cela prend tout son intérêt quand tu écris des bibliothèques de plus de vingt lignes, et encore plus si d'autres développeurs utilisent ton code.
(les déclarations de typage que tu défends sont aussi une forme de documentation, mais cela n'a pas l'air de t'effleurer l'esprit)