После нескольких попыток подобраться к данной технологии, стало ясно - отсутствие документации никак не продвинет технологию в массы.
Читать, что-то на форумах, в каких-то статьях и не понятном разделе "Руководства" - очень интересно, но кроме каши не дает ничего.
Первая проблема, это из-за развития технологии, что-то очень быстро устаревает, и получается, читая статью, изучаешь уже не актуальный подход.
Нет примеров кратких но самодостаточных, большинство тем возникали на форуме.
Нигде не сказано, что новым трендом в данной технологии является выделения mVc в отдельный bundle design.
Изобилие bem и enb в разных статьях, в документации должно быть что-то одно.
Ситуация вводящая в ступор:
- создаем страницу
bem create -l desktop.bundles -b index
на выходе получаем один файл index.bemjson.js;
- компилируем
bem make
, на выходе еще получаем 10 файлов.
WTF? Что за файлы, за что отвечают, являются ли они build файлами и не подлежат ручному редактированию?
Почему финишные файлы называются по разному, например index.html _index.css _index.js? Нельзя ли результат компиляции, что не подразумевает ручного редактирование перенести в подпапку distr например?
Очень нужна документация, по каждой технологии, устаревшие технологии документировать не первостепенно.
Показывать примеры и с подгрузкой данных через API, и динамическое изменение DOM.
Из того, что не критично, но хотелось бы получить:
- право переопределять константы BEM_CLASS и BEM_PARAMS_ATTR, ну не нравится мне i-bem и data-bem, хочу получить js и data-js;
- не нравится именование модулей i-bem__dom, i-bem как-то не вписывается в Code Style.
Из документаций которые покрывают 99% вопросов мне нравится https://docs.djangoproject.com/en/dev/ http://symfony.com/doc/current/index.html http://git-scm.com/doc - это те документации, которые рассказывает и о различных приемах, и о назначении, и полноценные use case.
Без документации очень высокий порог вхождения, хотя сама технология не сложна, но из-за кучи не собранной информации в ней разбираться трудно, долго.