Как вы документируете компоненты?

Какие удобные способы документации компонентов можно использовать?

1. Комменты в самом файле компонента не очень удобно
2. Создавать маркдаун файл рядом с компонентом - тогда файлов в 2 раза больше = свалка
3. Отдельная библа для демок выглядит перебором, если речь идет о рабочем темплейте, а не какой-то демо-версии.

Как внедрить документацию прямо в рабочий темплейт?