Merci pour ce journal bien écrit et équilibré.
Les commentaires ne sont pas de la documentation, en effet. Mais pourquoi ne pas placer la documentation au plus près du code. Voire dedans, comme Python le permet —avec même la notion de références croisées, même inter-projets.
Certes, certains langages de programmation sont plus égaux que d'autres en ce qui concerne la documentation, et la mode est au Javascript qui est un vieux langage modernisé, mais toujours pas corrigé pour inclure la documentation —c'est incompréhensible.
# /* commentaire ou documentation inline ? */
Posté par feth . En réponse au journal To comment or not to comment. That is the question.. Évalué à 5.
Merci pour ce journal bien écrit et équilibré.
Les commentaires ne sont pas de la documentation, en effet. Mais pourquoi ne pas placer la documentation au plus près du code. Voire dedans, comme Python le permet —avec même la notion de références croisées, même inter-projets.
Certes, certains langages de programmation sont plus égaux que d'autres en ce qui concerne la documentation, et la mode est au Javascript qui est un vieux langage modernisé, mais toujours pas corrigé pour inclure la documentation —c'est incompréhensible.