Souvent déterminer quelle est la bonne documentation est difficile pour le développeur. Après avoir passé pas mal de temps à résoudre un problème épineux, il lui est difficile de déterminer ce qu'il doit dire ; beaucoup de choses lui paraissent évidentes et donc passées sous silence pensant que le code suffit car assez parlant.
Un bonne pratique peut être d'ajuster les commentaires lors de la revue de code car avec un oeil extérieur…
[^] # Re: Commenter l'intention
Posté par cosmocat . En réponse au journal To comment or not to comment. That is the question.. Évalué à 6.
Souvent déterminer quelle est la bonne documentation est difficile pour le développeur. Après avoir passé pas mal de temps à résoudre un problème épineux, il lui est difficile de déterminer ce qu'il doit dire ; beaucoup de choses lui paraissent évidentes et donc passées sous silence pensant que le code suffit car assez parlant.
Un bonne pratique peut être d'ajuster les commentaires lors de la revue de code car avec un oeil extérieur…