Максим Морев, я всё же имел ввиду автоматизированное составление Table of contents таск раннером, когда некоторый npm-пакет(коих, к слову, для scss я подходящих в своё время не нашёл и приколхозил пакет grunt'а к gulp'u) парсит упомянутое "документирование" и на его основании генерирует оглавление.
Потому как, да, ручные правки абсолютно не оправданы.
Других кейсов, когда необходимо документирование CSS я просто не могу придумать.
Пашенька, лол, как-то даже в голову не приходило, что такое есть. Даже пакет уже существует, но количество загрузок неиллюзорно даёт понять, насколько оно нужно. Раньше - может быть, с появлением препроцессоров в этом и толку нет никакого.
Лично у меня через sassDoc размечены все функции и миксины, и в том есть толк, так как редактор подсказывает аргументы. А в компонентах - не знаю, разве что если оба псевдоэлемента используются и с первого взгляда не очевидно, что за что отвечает - подпишу. А вообще да, хорошие стили сами себя документируют. Да и не только стили :))
