Какие удобные способы документации компонентов можно использовать?
1. Комменты в самом файле компонента не очень удобно
2. Создавать маркдаун файл рядом с компонентом - тогда файлов в 2 раза больше = свалка
3. Отдельная библа для демок выглядит перебором, если речь идет о рабочем темплейте, а не какой-то демо-версии.
Как внедрить документацию прямо в рабочий темплейт?
По-моему, все варианты перебор. Правда я новичок в данной теме (2 месяца), может речь идет о том, чего я не понимаю..) Мое мнение- если для создания сайтов, то: понятное название вложенных папок + название компонентов + комментирование в файлах.