Pour moi je trouve qu'il est aussi assez important de donner le sens en langage naturel de ce que je fais. (bien sûr pas à toutes les lignes).
Je me moque un peu de la h4ck3r attitude qui dit que tu devrais "lire dans le code". Moi je pense que le code ne résume pas souvent une situation. Donc avant le code d'un algorithme j'aime expliquer le but de l'algorithme (éviter dêtre le nez dans le guidon).
Je pense en plus que lors d'une maintenance on est aussi plus apte à voir l'erreur (est-ce une erreur de conception, ou d'implementation de l'algorithme).
C'est un peu comme quand on se lance dans un argumentaire (type publication scientifique), on explique d'abord pourquoi on va emmener le lecteur dans tel ou tel direction avant de se lancer dans le détail. Ce n'est pas la peine que tout le monde réinvente le raisonement qui t'emmène à la construction du code et en plus en sens inverse !
[^] # Re: Je commente mon code :
Posté par Alex G. . En réponse au sondage Je commente mon code :. Évalué à 2.
Je me moque un peu de la h4ck3r attitude qui dit que tu devrais "lire dans le code". Moi je pense que le code ne résume pas souvent une situation. Donc avant le code d'un algorithme j'aime expliquer le but de l'algorithme (éviter dêtre le nez dans le guidon).
Je pense en plus que lors d'une maintenance on est aussi plus apte à voir l'erreur (est-ce une erreur de conception, ou d'implementation de l'algorithme).
C'est un peu comme quand on se lance dans un argumentaire (type publication scientifique), on explique d'abord pourquoi on va emmener le lecteur dans tel ou tel direction avant de se lancer dans le détail. Ce n'est pas la peine que tout le monde réinvente le raisonement qui t'emmène à la construction du code et en plus en sens inverse !