Volgens mij is de meerwaarde van documentatie bij CSS eerder miniem. Als je een tool als firebug kunt gebruiken om alles te gaan inspecteren denk ik niet dat ik persoonlijk de moeite zou doen om eerst in de docs te gaan opzoeken… Daarbij komt nog eens het feit dat die commentaar ook zijn bits en bytes zal nodig hebben omdat CSS plain text is en dat geeft dan weer zijn nadelen qua snelheid en zo. Als programmeur ben ik absoluut voorstander van degelijke commentaar en uitleg in je code, maar ik denk dat het voor CSS niet meteen aan de orde is.

Ja, je hebt daar een punt. Maar ik was het zowieso niet van plan te gebruiken om tussen alle CSS declaraties commentaar te voorzien. Wel eerder om bovenaan de CSS file uitleg over die file te geven, copyrights, datum van aanmaak en wijzigingen. Bij complexe CSS files zou je het eventueel wel kunnen toepassen om extra info bij bepaalde declaraties te geven. Kan handig zijn als meerdere mensen in die file moeten werken. Je kan die comments dan als het nodig is er weer uit strippen via een CSS optimizer tool. Maar het zal inderdaad niet even toepasselijk zijn als bijvoorbeeld bij PHP.