Voici trois parties d'un code: l'algorithme qui fait tourner le programme, la structure de données sur laquelle s'appuie l'algorithme, et le commentaire qui rend plus explicite le code. Jeu: laquelle de ces trois parties est la plus importante? Réponse: la structure de données. Pourquoi? Ecrivez un code avec la structure de données, l'algorithme et les commentaires. Supprimez les commentaires: cela compile toujours et cela marche toujours. Remettez les commentaires mais supprimez l'algorithme. Cela compile toujours et même si le programme ne fait rien, il s'exécute encore. Remettez l'algorithme, gardez les commentaires, mais supprimez la structure de données. Le programme ne compilera pas et s'exécutera encore moins! On pourrait aller plus loin en changeant un de ces trois éléments. Le changement de commentaires n'affecte pas l'exécution du programme. Un changement d'algorithme permet au programme d'aller plus vite ou moins vite suivant le nouvel algorithme choisi. Un changement de structure de données ne se fait pas sans une relecture de l'algorithme et éventuelle adaptation des commentaires!

Commentez votre code, monsieur, commentez votre code. Cette remarque vient souvent de gens qui sont incapable de lire votre code, sous-entendu la partie algorithmique du code. En effet, ces gens n'ont pas lu la structure de données ou ne l'ont pas comprise, et votre code n'est pas forcément clair. Commenter son code est cependant rarement nécessaire. En effet, si votre code est clair, basé sur votre structure de données elle-même d'une logique qui n'a d'égale que sa simplicité, et que vous avez suivi certaines règles de base, alors les commentaires qui pourraient encore être nécessaires seraient des références à des ouvrages qui expliquent la théorie et les algorithmes que vous avez utilisés, ou alors des commentaires indiquant des cas particulier et pourquoi ils sont particuliers. Le reste n'est qu'une affaire de bien programmer en suivant certaines règles.