Un bon nom met fin au débat

Un bon nom
met fin au débat.

Quand une chose est bien nommée,
on cesse d'en discuter.
On sait ce qu'elle fait.
On sait où elle vit.

Un mauvais nom
oblige à lire le corps
pour deviner l'intention.
Un bon nom
rend le corps presque inutile.

Nommer, c'est comprendre.
Si tu ne trouves pas le nom,
souvent tu n'as pas encore
compris la chose.

Le nom vague
cache une idée vague.
« data », « manager », « helper » :
des noms qui ne promettent rien
et ne tiennent rien.

Prends le temps du nom.
C'est le commentaire
que le code n'efface jamais.

La plupart des disputes
autour d'une fonction
disparaissent
dès qu'on lui donne
le nom juste.

Si tu ne sais pas la nommer,
tu ne la comprends pas encore.

– Serguey Asael Shinder