Встретилась на Хабре весьма полезная статья про сложность инструкций. Существующая документация отличная, но когнитивное сопротивление у неё на самом деле очень высокое. Сейчас по терминологии Купера я уже "апологет" и нормально ориентируюсь в документации. Но по ощущениям множество "уцелевших" не могут воспользоваться замечательными инструментами, в первую очередь из-за сложности входа в мир БЭМ. Очень хочется цитировать вторую главу "Психбольницы в руках пациентов", а параграф про "Апологетов и уцелевших" хоть полностью сюда вставляй.
Ты же видел мой пост с попыткой собрать всю терминологию? У меня еще появилась идея собрать эту терминологию и визуализировать со связями: мол, что за что цепляется, что на что влияет, и куда все это катится.
Иначе, действительно на нас как на психов смотрят ;-)
Да, все так. Что мы с этим делаем прямо сейчас: 1) Хотим распилить сам сайт bem.info на относительно отдельные подсайты, чтобы был явно разделен скоуп. Предполагается такая структура:
/— продающий лендинг с тремя большими кнопками/ссылками, уводящими на разделы Методология, Платформа и Сообщество.В разделе Методология не будет вообще ничего про BEMJSON/i-bem.js/etc. Только идея в чистом виде. Документация для этого раздела сейчас в процессе переосмысления (часть новых документов уже на вычитке, мы их опубликуем еще в рамках текущего сайта).
Раздел про Платформу тоже будет представлен продающим лендингом, который в свою очередь уводит посетителей на подразделы про Технологии, Инструменты, Библиотеки, etc. У каждой технологии и библиотеки — собственный подсайтик.
В Сообщество попадет все про общение, статьи, FAQ, библиотеки и так далее.
Мы надеемся, что такая явная структуризация информации позволит новичкам не заблудиться и двигаться четко последовательно от общего к частному (те самые связи, о которых @zxqfox ).
2) Мы собираемся добавить больше реальных примеров и возможность их запускать прямо на сайте. К этой задаче еще не приступали, она следующая на очереди.
Ну и, конечно, мы всячески приветствуем любую помощь начиная от фидбека типа «вот тут какая-то фигня написана, два раза прочитал, ничего не понял» и до пулл-реквестов с улучшениями или целыми статьями от сообщества. Со своей стороны поможем их вычитать, дополнить и перевести.
Купер вообще молодчина :) Кардинально поменял взгляд на разработку.
@tadatuta Был бы рад участвовать в вычитке, если есть таковая возможность. На собственный труд времени и сил не найду к сожалению. Ну а комменты и PR делать не стесняемся. Отдельное спасибо @tadatuta за оперативную и всеобъемлющую поддержку на форуме и всем причастным за огромную коллекцию документации. Всё же без неё погружение стало бы вовсе невозможным.
@tadatuta "Мечты сбываются" :smiley: как раз именно это (или почти это) я представлял, когда писал https://github.com/bem/bem-forum-content-ru/issues/260
Палю тему :) https://github.com/bem/bem-method/blob/naming-convention/method/naming/naming.ru.md + https://github.com/bem/bem-method/tree/new-method-description/method/naming
@tadatuta А как переводы делаются? Заводятся issue на перевод того или иного материала?
Еще, мы как-то с @varya обсуждали, что, возможно, сейчас нехватает для новичков более обширного раздела "руководства" с темами вроде "используем шаблоны на клиенте". Сборника с рецептами.
@tadatuta вопрос немного не в тему :)
На Яндекс.Почта в вёрстке присутствуют такие сущности, как например
b-messages__message__right- это отголоски прошлого? Или что-то значит?У них там свой мир и они решили, что им это надо и есть элементы элементов