Спасибо

На чём основан whitepaper? Я о сайте https://whitepaper.tools

Я пишу документацию и хочу сослаться на авторитетный источник концепции описания тем. Но сайт whitepaper содержит только русскоязычную версию методологии и похоже он не развивается и не рассказывает о инструментах, в нём даже о themekit не нашел ни слова.

Наверняка эта идея не нова, как и всё в этом мире, а на чём-то базируется. Если вы знаете источники, расскажите об этом. Желательно, что бы это было что-то вроде https://bem.info, на который я могу сослаться что бы пояснить за БЭМ

Я ожидаю, что на страницах методологии будет рассказано о том, как следует описывать темы токенами, о структуре описания, обоснование такой структуры. Это может быть любой гайд который нравится вам, главное что бы он был популярным, подробным и с примерами

В тот момент, когда пилили сайт whitepaper, использовали bem-project-stub для вёрстки кастомных страниц и Docsify для раздела с документацией.

Сейчас думаю есть более актуальные инструменты, тот же с Storybook.

Вопрос о гайдах описания дизайн токенов, а не о технологиях сайта

боюсь, что пока подобных гайдов нет :(

пока в качестве источника лучших практик можно смотреть на то, как реализован https://github.com/bem/yandex-ui (удобно через https://bem.github.io/yandex-ui-themer/) и послушать доклад Нади @nadia_nashirbanova: https://youtu.be/wTkeS-X_OIU?t=615

Спасибо, посмотрю.

А у кого-нибудь есть в планах выпустить какой-то текстовый свод рекомендаций и аргументации к ним, объяснений почему предлагаете именно так?

cc @yarastqt

Для контекста, уточню, что я говорю не о yandex-ui, а о абстрактном документе, в котором будут описаны лучшие практики создания структур дизайн токенов, включая рекомендацию имён свойств.

Что бы можно было просто сослаться на такой документ в любом проекте и прочитавший его сразу понимал как ему следует писать токены для своей части кода. Что-то вроде БЭМ или https://www.conventionalcommits.org

А yandex-ui выше упомянули как пример структуры токенов

В планах есть написать документ про токены и как мы их строим, какая структура и почему

раз упомянули https://bem.github.io/yandex-ui-themer/, как выгрузить тему? загрузить есть, а как выгрузить?

Я поигрался с токенами yandex-ui и обнаружил что не получается просто изменить ключевые цвета с светлого на тёмный и что бы всё работало. Нужно переписывать конкретные цвета. Я думаю о том, что бы использовать не просто токены "первичный/вторичный цвет текста", а "темный/светлый цвет текста". При этом сам цвет не важен, контракт в том, что темный цвет будет нормально выглядеть на светлом фоне и наоборот. Что ты думаешь о таком подходе?

речь же идет о системе - поэтому и подход должен быть системным - создавать новую тему

если речь идет о бессистемном изменении параметров разметки - ничто не мешает прокидывать кастомные классы в любой компонент в любом месте - но это антипаттерн

Часто бывают задачи, когда нужно на сайт добавить временную верстку для какой-то акции или промо. Новые блоки провисят на сайте недельку и потом их отключают.
Логично эти блоки выделить в отдельный слой, в понятиях бэма, собирать в отдельный бандл и подключать после основного. Задался вопросом: где хранить эти блоки?
- со всеми рядом в папке blocks
- создавать папку для каждого отдельного промо наподобии new-year-blocks
- создать слой для всех промо-блоков и назвать promo-blocks или temp-blocks

Что думаете на этот счет? Как практикуете?

blocks-promo, blocks/promo-* — норм

лучше blocks префиксом, чтобы на файловой системе были рядом

а может ли один тег одновременно быть 2 элементами одного блока?
типа
.header
 a.header__logo.header__link

Да

Только тут всё же больше похоже н модификатор:

.header
 a.header__logo.header_type_link