Je suis d'accord avec toi sur certains points : certains documents sont très utiles (celui qui décrit les entrées sorties par exemple, ceux qui documentent l'architecture également, et bien d'autres). Mais certains sont inutiles voir nuisibles : tous ceux qui concernent le code de manière trop précise sont voués à être désynchronisés. Je pense que pas mal de développeur ont vécu le cas où on leur file une doc et un code qui ont évolué séparément. A ce moment là les ennuis commencent ; ça doit expliquer certaines réactions épidermique sur cette dépêche.
Une solution est d'utiliser des softs genre doxygen qui évitera cette désynchronisation.
[^] # Re: la spec, c'est le code
Posté par guppy . En réponse à la dépêche Développement très rapide d’applications libres : Extended Man/XML Frames. Évalué à 3.
Je suis d'accord avec toi sur certains points : certains documents sont très utiles (celui qui décrit les entrées sorties par exemple, ceux qui documentent l'architecture également, et bien d'autres). Mais certains sont inutiles voir nuisibles : tous ceux qui concernent le code de manière trop précise sont voués à être désynchronisés. Je pense que pas mal de développeur ont vécu le cas où on leur file une doc et un code qui ont évolué séparément. A ce moment là les ennuis commencent ; ça doit expliquer certaines réactions épidermique sur cette dépêche.
Une solution est d'utiliser des softs genre doxygen qui évitera cette désynchronisation.