Автоматическое создание style guide для сайта

#javascript #scss #style_guide

Мудрые люди подскажите пожалуйста, что лучше использовать для автоматизированного
создания style guide из комментариев в scss

Буду очень признательна

UPD 

Пример комментариев:

// A button suitable for giving a star to someone. 
// :hover - Subtle hover highlight. 
// .star-given - A highlight indicating you've already given a star. 
// .star-given:hover - Subtle hover highlight on top of star-given styling. 
// .disabled - Dims the button to indicate it cannot be used.

    

Ответы

Ответ 1

Предполагаю, что отличным вариантом станет инструмент KSS, пример комментариев вы
сами и привели, и который работает с SCSS.

Собственно, пример комментариев с кодом:

// A button suitable for giving stars to someone.
//
// :hover             - Subtle hover highlight.
// .stars-given       - A highlight indicating you’ve already given a star.
// .stars-given:hover - Subtle hover highlight on top of stars-given styling.
// .disabled          - Dims the button to indicate it cannot be used.
//
// Styleguide 2.1.3.
a.button.star{
  …
  &.star-given{
    …
  }
  &.disabled{
    …
  }
}


И пример генерируемой доки - http://primercss.io/buttons/

P.S. Все примеры с оффсайта.