J'aurai tendance à dire que les deux se complètent et ne répondent pas au même besoin. Les commentaire du code servent pendant qu'on parcoure le code source et doivent réflecter l'état du moment (pas seulement programmatiquement) Les messages de commit doivent donner les indications sur l'évolution du code (et le journaliser) sans forcément être tout aussi technique (toute façon presque personne ne lit le message détaillé...) Cf. https://reflectoring.io/meaningful-commit-messages/ pour les messages de commit.
"It is seldom that liberty of any kind is lost all at once." ― David Hume
[^] # Re: re: Best practices for writing code comments
Posté par Gil Cot ✔ (site web personnel, Mastodon) . En réponse au lien Best practices for writing code comments. Évalué à 3.
J'aurai tendance à dire que les deux se complètent et ne répondent pas au même besoin. Les commentaire du code servent pendant qu'on parcoure le code source et doivent réflecter l'état du moment (pas seulement programmatiquement) Les messages de commit doivent donner les indications sur l'évolution du code (et le journaliser) sans forcément être tout aussi technique (toute façon presque personne ne lit le message détaillé...) Cf. https://reflectoring.io/meaningful-commit-messages/ pour les messages de commit.
"It is seldom that liberty of any kind is lost all at once." ― David Hume