Table des matières

Une table des caractères est un élément dont la maintenance est substentielle, mais les bénéfices données dépassent largement ses coûts. Il requiert un développeur appliqué de maintenir une table des matières à jour, mais le jeu en vaut la chandelle. Une table des matières fourni à l'équipe une référence uniique et complète de ce que contient le projet CSS, de ce qu'il fait, et dans quel ordre.

Une simple table des matière fourni simplement le nom dom d'une section et ce qu'elle fait, par exemple :

/**
 * CONTENTS
 *
 * SETTINGS
 * Global...............Globally-available variables and config.
 *
 * TOOLS
 * Mixins...............Useful mixins.
 *
 * GENERIC
 * Normalize.css........A level playing field.
 * Box-sizing...........Better default `box-sizing`.
 *
 * BASE
 * Headings.............H1–H6 styles.
 *
 * OBJECTS
 * Wrappers.............Wrapping and constraining elements.
 *
 * COMPONENTS
 * Page-head............The main page header.
 * Page-foot............The main page footer.
 * Buttons..............Button elements.
 *
 * TRUMPS
 * Text.................Text helpers.
 */

Each item maps to a section and/or include.

Naturellement, cette section devrait être largement plus grande sur une majorité de projets, mais heureusement nous pouvons voir comment cette section — dans la feuille de style principale — fourni au développeur une vue d'ensemble du projet, de ce qui est utilisé et pourquoi.