Le code résout le problème, les commentaires nous disent comment

Les commentaires décrivent le

code pour les développeurs. La

documentation  du code décrit ses fonctionnalités aux utilisateurs

Le code vous dit comment; les commentaires vous disent pourquoi

Il est approprié d'utiliser d'abord

les commentaires pour planifier ou décrire une section de code