Оу, это платформа с документацией https://v2.docusaurus.io тут theme это просто алиас куда-то

Т.е. сам лейаут где-то в node_modules лежит

ok, поищу, спасибо

Подскажите тулзу для генирации документации, которой я могу скормить md файл и она разрезолвит в нём ссылки на другие md файлы и внутренние ссылки в них, всё прочитает и сделает это html страницами с нормальными ссылками друг на друга, а входящий файл сделает списком пунктов документации. Есть что-нибудь такое?

Офтопим про фронтенд в https://t.me/frontend_ru

Я там забанен

Есть шанс и тут бан получить за оффтопик ;)

Значит такой путь :)

Думаю, что нужно читать про gatsby, в частности

https://github.com/gatsbyjs/gatsby/blob/master/docs/docs/adding-markdown-pages.md

https://github.com/stephane-klein/gatsby-remark-convert-linker-from-md-to-html-example

Поддерживаю

Ну, раз пошла такая пьянка — я посоветую https://www.11ty.dev

то есть лучше, например
block_element--action-delete
?

Да, но это не полностью верный ответ. Нужно анализировать весь интерфейс, чтобы ответить верно. Например, понимание про курсив текста при наведении или цвет фон — откуда от «проистекает» (может, это повторяющийся паттерн и его можно выделить в какой-то отдельный модификатор_

ну тут как бы вот
есть обычные кнопки
и есть кнопки которые выполняют какие-то действия, по типу если
действие какое-то безопасное (имеется ввиду, выйти, зайти, закрыть, получить, копировать) то есть то которое не влияет непосредственно на контент, то просто цвет текста внутри кнопки меняется на зеленый при фокусе
если это действие как-то изменяет контент (перезаписывает, редактирует) то желтым
ну и если удаляет то красным

Это то, как ты их видишь, но пока ты мыслишь только в категории двух кнопок, толку от БЭМ будет мало, как бы ты их не именовал. БЭМ — это про поиск закономерностей, про способ «допроса» компонентов: «откуда ты получил эти свойства» (причём речь не только про CSS-свойства, но и про JS-методы, про семантику сущности). Результат «допроса» — выражается в именовании. Когда у тебя в интерфейсе появляется новая сущность (кнопка редактирования), но которая выглядит иначе, тут одна из двух причин:
1) накосячил дизайнер (исправляется косяк, кнопка становится однородного цвета)
2) цвет вообще не отражает признак, следует его вынести в другой модификатор (а что «заставило» кнопку «покраситься»в этот цвет? А если тут будет не эта кнопка, а вообще что-то другое, цвет сохранится? А отступы? А почему в разных частях интерфейса у кнопки с одинаковым контекстом разные цвета?)

Через какое-то время превращаешься в настоящего БЭМ-чекиста — с одного взгляда любой компонент сразу выдаёт все свои признаки и закономерности. Да и у тебя к этому времени будет полный арсенал разобранных по полочкам компонент, количество блоков сведётся к минимуму, все интерфейсы станут похожими и предсказуемыми.

На типичных проектах у меня новых блоков — не больше 10-15. Плюс «джентельменский набор» https://ru.bem.info/libraries/classic/bem-components/6.0.0 (не все, штук 10-12).

спасибо, спасибо, Рома, за такой развернутый ответ, аж пробило желание на углубленное изучение

🤙