Si comme moi vous aimez ce qui est conventionnel et d’une certaine rigueur, vous apprécierez ce commentaire de Linus sur les commentaires (non je n’ai pas honte).
Ses propos sont certes disproportionnés, mais se justifient dans le fond. Linus est un adepte des commentaires équilibrés, quitte à être sous différentes formes, mais cet équilibre peut se comprendre par des idées ordonnées que doit avoir le développeur.
Les modèles retenus sont donc les suivants :
/* Ceci est un commentaire */
/*
* Ceci est également un commentaire, mais il peut maintenant être proprement
* réparti sur plusieurs lignes
*/
// Cela peut être une seule ligne. Ou plusieurs. Selon votre choix.
Ou à la limite :
/* Ceci est une alternative au format multiligne
Linus estime que ce ce n’est pas horrible, mais pas le style du noyau */