Personnellement, j'essaie (quand je fais du code propre) de toujours ajouter un commentaire pour expliquer ce que fait la fonction, la tête des arguments et leurs valeurs potentielles, et la tête de ce que ça doit renvoyer

Avec souvent des références à l'algo en cours, c'est utile pour débugguer

(genre donner la correspondance de chaque ligne de code avec chaque ligne de l'algo théorique)