Давно хотел понять, пожалуйста поясните какой смыл в одинаковом содержании разделов платформ.
В документации библиотеки, например BEM Components страницы уровней переопределения "платформы" выглядят идентично с точки зрения документации.
Понятно что каждый уровень может содержать доопределения и какие именно можно разглядеть в табе "Source" (если внимательно присмотреться), и как следствие демонстрация блоков учитывает эти доопределения.
При этом дока, html, BEMJSON deps на первый взгляд идентичны.
Какая в этом польза?
@ilyar Ты все правильно написал: состав блоков может быть (и является) разным в зависимости от платформы. Тот факт, что для данных конкретных библиотек в данных конкретных версиях отличия не такие заметные — это лишь частный случай. Потенциально возможна ситуация, когда блок целиком может быть представлен лишь на одной из нескольких платформ либо выглядеть/вести себя принципиально по-разному (сравни, например, шапку мобильного Яндекса с десктопной версией).
https://twitter.com/ilyarsoftware/status/960636712857866240 Может кто-то рассказать или показать пример, как это может быть чтобы продублировать доку 3 раза и станет удобно и понятно.
Я все переживаю, как стек внедрить и притом не занимаясь написанием специальной доки для
bem.info.Source как раз отличается. А отсутствие отличий в JS API — это «случайное совпадение». Так уж вышло, что у блоков в
bem-core/bem-componentsдействительно все консистентно для любой платформы. А генератор документации был написан для общего случая.