bem-site / bem-forum-content-ru

Content BEM forum for Russian speak users
MIT License
56 stars 6 forks source link

Хабр: Когнитивное сопротивление правил и инструкций #313

Open Guria opened 9 years ago

Guria commented 9 years ago

Встретилась на Хабре весьма полезная статья про сложность инструкций. Существующая документация отличная, но когнитивное сопротивление у неё на самом деле очень высокое. Сейчас по терминологии Купера я уже "апологет" и нормально ориентируюсь в документации. Но по ощущениям множество "уцелевших" не могут воспользоваться замечательными инструментами, в первую очередь из-за сложности входа в мир БЭМ. Очень хочется цитировать вторую главу "Психбольницы в руках пациентов", а параграф про "Апологетов и уцелевших" хоть полностью сюда вставляй.

qfox commented 9 years ago

Ты же видел мой пост с попыткой собрать всю терминологию? У меня еще появилась идея собрать эту терминологию и визуализировать со связями: мол, что за что цепляется, что на что влияет, и куда все это катится.

Иначе, действительно на нас как на психов смотрят ;-)

tadatuta commented 9 years ago

Да, все так. Что мы с этим делаем прямо сейчас: 1) Хотим распилить сам сайт bem.info на относительно отдельные подсайты, чтобы был явно разделен скоуп. Предполагается такая структура: / — продающий лендинг с тремя большими кнопками/ссылками, уводящими на разделы Методология, Платформа и Сообщество.

В разделе Методология не будет вообще ничего про BEMJSON/i-bem.js/etc. Только идея в чистом виде. Документация для этого раздела сейчас в процессе переосмысления (часть новых документов уже на вычитке, мы их опубликуем еще в рамках текущего сайта).

Раздел про Платформу тоже будет представлен продающим лендингом, который в свою очередь уводит посетителей на подразделы про Технологии, Инструменты, Библиотеки, etc. У каждой технологии и библиотеки — собственный подсайтик.

В Сообщество попадет все про общение, статьи, FAQ, библиотеки и так далее.

Мы надеемся, что такая явная структуризация информации позволит новичкам не заблудиться и двигаться четко последовательно от общего к частному (те самые связи, о которых @zxqfox ).

2) Мы собираемся добавить больше реальных примеров и возможность их запускать прямо на сайте. К этой задаче еще не приступали, она следующая на очереди.

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

belozer commented 9 years ago

Купер вообще молодчина :) Кардинально поменял взгляд на разработку.

Guria commented 9 years ago

@tadatuta Был бы рад участвовать в вычитке, если есть таковая возможность. На собственный труд времени и сил не найду к сожалению. Ну а комменты и PR делать не стесняемся. Отдельное спасибо @tadatuta за оперативную и всеобъемлющую поддержку на форуме и всем причастным за огромную коллекцию документации. Всё же без неё погружение стало бы вовсе невозможным.

belozer commented 9 years ago

@tadatuta "Мечты сбываются" :smiley: как раз именно это (или почти это) я представлял, когда писал https://github.com/bem/bem-forum-content-ru/issues/260

tadatuta commented 9 years ago

Палю тему :) 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

apsavin commented 9 years ago

@tadatuta А как переводы делаются? Заводятся issue на перевод того или иного материала?

Еще, мы как-то с @varya обсуждали, что, возможно, сейчас нехватает для новичков более обширного раздела "руководства" с темами вроде "используем шаблоны на клиенте". Сборника с рецептами.

belozer commented 9 years ago

@tadatuta вопрос немного не в тему :)

На Яндекс.Почта в вёрстке присутствуют такие сущности, как например b-messages__message__right - это отголоски прошлого? Или что-то значит?

awinogradov commented 9 years ago

У них там свой мир и они решили, что им это надо и есть элементы элементов