Exemples de commentaire hierarchisés en CSS

hierarchisation.css

/* -------------------------------------------------------------------------- *\


	 # Commentaire de premier niveau 


\* -------------------------------------------------------------------------- */

/* ==========================================================================
   ## Commentaire de deuxième niveau
   ========================================================================== */

/* ### Commentaire de troisième niveau
   ========================================================================== */   

/**
 * Commentaire sur plusieurs lignes
 * Pour décrire un bloc complexe avec un code d'exemple
 */

/* Commentaire simple */


/* -------------------------------------------------------------------------- */
/*                              Cas pratique :                                */
/* -------------------------------------------------------------------------- */


/* -------------------------------------------------------------------------- *\


	 # Résultats de recherche
	 @search-index-index


\* -------------------------------------------------------------------------- */

.search {...}

	/* ==========================================================================
	   ## Moteur de recherche
	   ========================================================================== */
	.search__form {...}
		.search__form > div {...}
		
		/* ### Mise en forme des options de recherche
		   ========================================================================== */   
		.search__options {...}

	/* ==========================================================================
	   ## Liste des résultats
	   ========================================================================== */
	.search__results {...}