Документирование блоков. Раскрываем все плюсы — Инна Белая, ЯндексYandex
Мы поговорим о том, как разрабатывается техническая документация к библиотеке bem-components и почему разделение интерфейса на блоки облегчает работу с документами как техническим писателям, так и разработчикам. А также о том, как мы выкладываем всю информацию по каждому блоку с примерами и JSDoc на наш сайт bem.info.
Обзор техник и приёмов для более эффективной работы с пользовательской документацией к программным и техническим системам.
Данные подходы возможно использовать в различных программах для работы с документацией — как в системах единого источника, так и в более традиционных инструментах.
В качестве практической демонстрации большинство техник разобрано на примере программы Dr.Explain.
Доклад на hotcode.org о инструментах и методиках которые помогают нам повышать и следить за качеством PHP кода.
Среди затронутых тем:
- Стандарты в коде
- Средства для статического анализа кода.
- Git хуки
- Непрерывная интеграция
- IDE
- Code review
Документирование блоков. Раскрываем все плюсы — Инна Белая, ЯндексYandex
Мы поговорим о том, как разрабатывается техническая документация к библиотеке bem-components и почему разделение интерфейса на блоки облегчает работу с документами как техническим писателям, так и разработчикам. А также о том, как мы выкладываем всю информацию по каждому блоку с примерами и JSDoc на наш сайт bem.info.
Обзор техник и приёмов для более эффективной работы с пользовательской документацией к программным и техническим системам.
Данные подходы возможно использовать в различных программах для работы с документацией — как в системах единого источника, так и в более традиционных инструментах.
В качестве практической демонстрации большинство техник разобрано на примере программы Dr.Explain.
Доклад на hotcode.org о инструментах и методиках которые помогают нам повышать и следить за качеством PHP кода.
Среди затронутых тем:
- Стандарты в коде
- Средства для статического анализа кода.
- Git хуки
- Непрерывная интеграция
- IDE
- Code review
Как взаимодействовать с графическими дизайнерами: готовим UI Kit / Артем Моло...Ontico
Frontend-разработчики и веб-дизайнеры решают совместную задачу – чтобы пользователь получил лучший user experience. Но часто смотрят на проблему с разных позиций — либо наилучшего технического решения проблемы, либо художественного видения мира. Различие инженерных и художественных подходов нередко приводит к конфликту интересов и снижает эффективность работы команды. Однако поле битвы мировоззрений можно превратить в совместное рабочее пространство. В качестве основного подхода к поиску оптимального процесса создания и сопровождения визуального стиля веб-сайта рассматривается подготовка User Interface Kit (или UI Kit). UI Kit содержит элементы, которые служат кирпичами при построении единообразного интерфейса корпоративных веб-сайтов.
Из предлагаемого доклада слушатели смогут узнать следующее:
– какие плюсы предоставляет декомпозиция дизайна;
– что такое UI Kit и какими свойствами он обладает;
– почему работа с UI Kit понравится и разработчикам, и дизайнерам, и даже менеджеру проекта;
– как можно реализовать UI Kit и организовать его хранение.
JavaScript завтра / Сергей Рубанов (Exante Limited)Ontico
За последние несколько лет в мире js-разработки особое внимание получили такие проекты как AtScript, TypeScript, SoundScript, Flow, Traceur, Babel, каждый из которых пытается предоставить разработчикам некую "улучшенную" версию JavaScript. Комитет TC39 также стал очень активен и разработал стратегию развития стандарта ECMAScript с более частыми релизами. Движки JavaScript стремительно приближаются к полной поддержке ES6. Огромное количество JS-фреймворков и библиотек выбирают следующую версию стандарта уже сегодня. Это означает, что необходимо уже сегодня обратить внимание на происходящее в мире JavaScript-разработки и разобраться, что ждет язык завтра.
В своем докладе я постараюсь дать ответы на следующие вопросы:
- почему такие фреймворки и библиотеки как Angular, Ember, React начали активно и кардинально меняться;
- почему новая версия стандарта языка ES6 так долго внедряется вендорами браузеров и как TC39 решил ускорить процесс стандартизации и внедрения последующих версий ECMAScript;
- почему CoffeeScript больше не "just JavaScript", и действительно ли он сделал такой значимый вклад в следующую версию JavaScript;
- почему были созданы AtScript, TypeScript, Flow, чем каждый из них отличается от остальных, и как они влияют на дальнейшее развитие JavaScript;
- что такое Strong Mode и SoundScript;
- как начать писать ES6+ код уже сегодня.
С ростом кодовой базы становится все более очевидной необходимость использования компонентного подхода, когда каждая логическая часть обособлена. Если говорить про JavaScript, то в нем есть области видимости, опираясь на которые можно соорудить изолированные компоненты. Но в CSS нет подобных механизмов, поэтому и придумываются Shadow DOM (Web Components) и различные методики вроде БЭМ.
Но что если взглянуть на проблему под другим углом? Адаптируя подходы, что уже используются для других задач, можно получить куда больше выгоды, чем просто изолированные стили!
26.03.19 Collaborator.pro Webinar Эффективные паттерны выбора доноров
Видеозапись - https://www.youtube.com/watch?v=ZJF0NASNi4Y
Как правильно выбрать донора для продвижения сайта. Как оценивать "пузомерки" и зачем это нужно.
Спонсоры вебинара:
http://collaborator.pro/ — биржа прямой рекламы, продажа гостевых статей
http://referr.ru/ — сервис крауд-маркетинга
Гость: Владислав Моргун https://www.facebook.com/vladislav.morgun.3
Ведущий: Игорь Рудник: https://www.facebook.com/irudnyk
О чем вебинар?
1. Как считаются метрики физически, а не философски
2. Почему DR больше 30 не значит, что площадка нам подходит
3. Паттерны выбора площадок
4. Автоматизация оценки доноров
Подписывайтесь, чтобы быть в курсе новых вебинаров:
https://www.facebook.com/collaborator.platform/
https://t.me/mflow
Экосистема или зоопарк / Федор Щудло (EastBanc Technologies)Ontico
РИТ++ 2017, Frontend Сonf
Зал Мумбаи, 6 июня, 17:00
Тезисы:
http://frontendconf.ru/2017/abstracts/2523.html
Это история о том, как вести параллельную работу над дизайном и frontend нескольких десятков систем, представляющих из себя единую экосистему.
Как от “стихийной” разработки и уймы повторяющегося кода перейти к написанию библиотек для самих себя, сделать своими пользователями своих же разработчиков, а что-то даже выложить в open source. И почему выкладывать в open source важно, и вам тоже следует это делать.
...
Слайды с одноименного доклада на IT Global Meetup 2015, прошедшего в Санкт-Петербурге 6 июля.
Тезисы:
* Контроль за качеством кода - это необходимая процедура при работе нескольких человек в одной команде над продуктом из более чем сотни строк. Зачем это нужно? Каждый пишет код по-своему, ожидает понимания от остальных участников команды, но в жизни этого не происходит.
* Недостатки разнобоя в стиле написанного кода: увеличивается время ревью, усложняется внесение правок кем-либо кроме автора кода, увеличивается вероятность пропустить глазами ошибку.
* Основные шаги к решению этой проблемы: создание единого свода правил по оформлению кода (style guide), согласование процедуры разрешения конфликтных ситуаций относительно разночтений этих правил, устранение человеческого фактора в процессе оценки через автоматизацию.
* Что из экосистемы Питона может помочь? При составлении style guide можно взять за основу PEP8 и PEP257, дополнив их принятыми в команде конвенциями (какие кавычки использовать для строк и докстрингов, и т.д. и т.п.). Автоматизировать проверки можно как с помощью уже готовых утилит (pep8, flake8, pylint), так и написав свои с помощью встроенного в язык инструментария (модули ast, tokenizer, сторонние библиотеки для работы с кодом).
* Где производить проверки? Есть несколько возможных этапов:
- IDE разработчика
- Локальная VCS (working copy)
- Общая VCS
- Сервер Continous Integration.
В идеале проверки должны быть на каждом этапе, но при этом как можно меньше затруднять обычный рабочий процесс. Здесь стоит задуматься, какая комбинация из этих этапов лучше всего впишется в стиль разработчки команды.
* Если же нет достаточных ресурсов или проект находится
19.06.19 - MAD SEO Conf v.2.0 by Govitall - SEO-адаптация продуктов для выход...Vladislav Morgun
19 Июня 2019 года выступил на мини конференции MAD SEO Conf v.2.0 by Govitall где рассказал о том как работать с другими языками, которых вы можете даже не знать.
Документирование блоков. Раскрываем все плюсыYandex
Документирование блоков. Раскрываем все плюсы
Мы поговорим о том, как разрабатывается техническая документация к библиотеке bem-components и почему разделение интерфейса на блоки облегчает работу с документами как техническим писателям, так и разработчикам. А также о том, как мы выкладываем всю информацию по каждому блоку с примерами и JSDoc на наш сайт ru.bem.info.
Инна Белая, Яндекс
Разработчик технической документации в бригаде документирования БЭМ. В Яндексе с 2013 года.
Чат-бот как новый способ взаимодействия с клиентомVoximplant
Елизавета Лаврова (Microsoft)
Чат-бот как новый способ взаимодействия с клиентом
О докладе:
В последнее время все более естественным становится взаимодействие между человеком и компьютером. Диалоговая форма общения, которая является естественной для взаимодействия людей, может стать естественной и для взаимодействия людей и компьютеров. Сейчас на пике моды находятся чат-боты, которые, по оценкам аналитиков, являются серьезной альтернативой веб-приложениям. В докладе мы расскажем о том, почему чат-боты так популярны, какие задачи они способны решать, а также познакомимся с некоторыми примерами чат-ботов.
О спикере:
В июне 2016 года окончила МГТУ им. Н.Э. Баумана с присвоением квалификации магистра по направлению «Биометрические технологии идентификации личности». Специализируется в области когнитивных технологий и анализа данных в компании Microsoft.
INTERCOM 2016, Москва
Сайт конференции: https://intercomconf.com/
Microsoft Edge и платформа веб-приложений в Windows 10 / Константин Кичинский...Ontico
Microsoft Edge -- новый браузер от Microsoft с новым движком и новым интерфейсом.
Какие цели преследует Microsoft, и что это нововведение означает для веб-разработчиков?
Что нового в движке браузера по сравнению с IE, и как он будет развиваться дальше?
Движок Edge внутри Windows 10: хостинг сайтов внутри приложений и доступ к нативной функциональности.
Дорожная карта: к чему и когда готовиться?
Как взаимодействовать с графическими дизайнерами: готовим UI Kit / Артем Моло...Ontico
Frontend-разработчики и веб-дизайнеры решают совместную задачу – чтобы пользователь получил лучший user experience. Но часто смотрят на проблему с разных позиций — либо наилучшего технического решения проблемы, либо художественного видения мира. Различие инженерных и художественных подходов нередко приводит к конфликту интересов и снижает эффективность работы команды. Однако поле битвы мировоззрений можно превратить в совместное рабочее пространство. В качестве основного подхода к поиску оптимального процесса создания и сопровождения визуального стиля веб-сайта рассматривается подготовка User Interface Kit (или UI Kit). UI Kit содержит элементы, которые служат кирпичами при построении единообразного интерфейса корпоративных веб-сайтов.
Из предлагаемого доклада слушатели смогут узнать следующее:
– какие плюсы предоставляет декомпозиция дизайна;
– что такое UI Kit и какими свойствами он обладает;
– почему работа с UI Kit понравится и разработчикам, и дизайнерам, и даже менеджеру проекта;
– как можно реализовать UI Kit и организовать его хранение.
JavaScript завтра / Сергей Рубанов (Exante Limited)Ontico
За последние несколько лет в мире js-разработки особое внимание получили такие проекты как AtScript, TypeScript, SoundScript, Flow, Traceur, Babel, каждый из которых пытается предоставить разработчикам некую "улучшенную" версию JavaScript. Комитет TC39 также стал очень активен и разработал стратегию развития стандарта ECMAScript с более частыми релизами. Движки JavaScript стремительно приближаются к полной поддержке ES6. Огромное количество JS-фреймворков и библиотек выбирают следующую версию стандарта уже сегодня. Это означает, что необходимо уже сегодня обратить внимание на происходящее в мире JavaScript-разработки и разобраться, что ждет язык завтра.
В своем докладе я постараюсь дать ответы на следующие вопросы:
- почему такие фреймворки и библиотеки как Angular, Ember, React начали активно и кардинально меняться;
- почему новая версия стандарта языка ES6 так долго внедряется вендорами браузеров и как TC39 решил ускорить процесс стандартизации и внедрения последующих версий ECMAScript;
- почему CoffeeScript больше не "just JavaScript", и действительно ли он сделал такой значимый вклад в следующую версию JavaScript;
- почему были созданы AtScript, TypeScript, Flow, чем каждый из них отличается от остальных, и как они влияют на дальнейшее развитие JavaScript;
- что такое Strong Mode и SoundScript;
- как начать писать ES6+ код уже сегодня.
С ростом кодовой базы становится все более очевидной необходимость использования компонентного подхода, когда каждая логическая часть обособлена. Если говорить про JavaScript, то в нем есть области видимости, опираясь на которые можно соорудить изолированные компоненты. Но в CSS нет подобных механизмов, поэтому и придумываются Shadow DOM (Web Components) и различные методики вроде БЭМ.
Но что если взглянуть на проблему под другим углом? Адаптируя подходы, что уже используются для других задач, можно получить куда больше выгоды, чем просто изолированные стили!
26.03.19 Collaborator.pro Webinar Эффективные паттерны выбора доноров
Видеозапись - https://www.youtube.com/watch?v=ZJF0NASNi4Y
Как правильно выбрать донора для продвижения сайта. Как оценивать "пузомерки" и зачем это нужно.
Спонсоры вебинара:
http://collaborator.pro/ — биржа прямой рекламы, продажа гостевых статей
http://referr.ru/ — сервис крауд-маркетинга
Гость: Владислав Моргун https://www.facebook.com/vladislav.morgun.3
Ведущий: Игорь Рудник: https://www.facebook.com/irudnyk
О чем вебинар?
1. Как считаются метрики физически, а не философски
2. Почему DR больше 30 не значит, что площадка нам подходит
3. Паттерны выбора площадок
4. Автоматизация оценки доноров
Подписывайтесь, чтобы быть в курсе новых вебинаров:
https://www.facebook.com/collaborator.platform/
https://t.me/mflow
Экосистема или зоопарк / Федор Щудло (EastBanc Technologies)Ontico
РИТ++ 2017, Frontend Сonf
Зал Мумбаи, 6 июня, 17:00
Тезисы:
http://frontendconf.ru/2017/abstracts/2523.html
Это история о том, как вести параллельную работу над дизайном и frontend нескольких десятков систем, представляющих из себя единую экосистему.
Как от “стихийной” разработки и уймы повторяющегося кода перейти к написанию библиотек для самих себя, сделать своими пользователями своих же разработчиков, а что-то даже выложить в open source. И почему выкладывать в open source важно, и вам тоже следует это делать.
...
Слайды с одноименного доклада на IT Global Meetup 2015, прошедшего в Санкт-Петербурге 6 июля.
Тезисы:
* Контроль за качеством кода - это необходимая процедура при работе нескольких человек в одной команде над продуктом из более чем сотни строк. Зачем это нужно? Каждый пишет код по-своему, ожидает понимания от остальных участников команды, но в жизни этого не происходит.
* Недостатки разнобоя в стиле написанного кода: увеличивается время ревью, усложняется внесение правок кем-либо кроме автора кода, увеличивается вероятность пропустить глазами ошибку.
* Основные шаги к решению этой проблемы: создание единого свода правил по оформлению кода (style guide), согласование процедуры разрешения конфликтных ситуаций относительно разночтений этих правил, устранение человеческого фактора в процессе оценки через автоматизацию.
* Что из экосистемы Питона может помочь? При составлении style guide можно взять за основу PEP8 и PEP257, дополнив их принятыми в команде конвенциями (какие кавычки использовать для строк и докстрингов, и т.д. и т.п.). Автоматизировать проверки можно как с помощью уже готовых утилит (pep8, flake8, pylint), так и написав свои с помощью встроенного в язык инструментария (модули ast, tokenizer, сторонние библиотеки для работы с кодом).
* Где производить проверки? Есть несколько возможных этапов:
- IDE разработчика
- Локальная VCS (working copy)
- Общая VCS
- Сервер Continous Integration.
В идеале проверки должны быть на каждом этапе, но при этом как можно меньше затруднять обычный рабочий процесс. Здесь стоит задуматься, какая комбинация из этих этапов лучше всего впишется в стиль разработчки команды.
* Если же нет достаточных ресурсов или проект находится
19.06.19 - MAD SEO Conf v.2.0 by Govitall - SEO-адаптация продуктов для выход...Vladislav Morgun
19 Июня 2019 года выступил на мини конференции MAD SEO Conf v.2.0 by Govitall где рассказал о том как работать с другими языками, которых вы можете даже не знать.
Документирование блоков. Раскрываем все плюсыYandex
Документирование блоков. Раскрываем все плюсы
Мы поговорим о том, как разрабатывается техническая документация к библиотеке bem-components и почему разделение интерфейса на блоки облегчает работу с документами как техническим писателям, так и разработчикам. А также о том, как мы выкладываем всю информацию по каждому блоку с примерами и JSDoc на наш сайт ru.bem.info.
Инна Белая, Яндекс
Разработчик технической документации в бригаде документирования БЭМ. В Яндексе с 2013 года.
Чат-бот как новый способ взаимодействия с клиентомVoximplant
Елизавета Лаврова (Microsoft)
Чат-бот как новый способ взаимодействия с клиентом
О докладе:
В последнее время все более естественным становится взаимодействие между человеком и компьютером. Диалоговая форма общения, которая является естественной для взаимодействия людей, может стать естественной и для взаимодействия людей и компьютеров. Сейчас на пике моды находятся чат-боты, которые, по оценкам аналитиков, являются серьезной альтернативой веб-приложениям. В докладе мы расскажем о том, почему чат-боты так популярны, какие задачи они способны решать, а также познакомимся с некоторыми примерами чат-ботов.
О спикере:
В июне 2016 года окончила МГТУ им. Н.Э. Баумана с присвоением квалификации магистра по направлению «Биометрические технологии идентификации личности». Специализируется в области когнитивных технологий и анализа данных в компании Microsoft.
INTERCOM 2016, Москва
Сайт конференции: https://intercomconf.com/
Microsoft Edge и платформа веб-приложений в Windows 10 / Константин Кичинский...Ontico
Microsoft Edge -- новый браузер от Microsoft с новым движком и новым интерфейсом.
Какие цели преследует Microsoft, и что это нововведение означает для веб-разработчиков?
Что нового в движке браузера по сравнению с IE, и как он будет развиваться дальше?
Движок Edge внутри Windows 10: хостинг сайтов внутри приложений и доступ к нативной функциональности.
Дорожная карта: к чему и когда готовиться?
Presentation by the National Media Museum of their Learning Circle testing at Assist Social Capital's conference on the Nopros Grundtvig Project in Edinburgh, 1st of July 2011
Виталий Харисов "История создания БЭМ. Кратко, сбивчиво и неполно"Yandex
Как мы делали БЭМ. Почему некоторые места сделаны именно так. Что лежит в основе методологии. Что важно, а что можно менять по своему вкусу. Какие технологии мы используем и как они облегчают нам разработку.
Презентация «Drupal и SEO» с московской DrupalConf 2011Alexey Kostin
1. Общие подходы к поисковой оптимизации сайта с учётом актуальных формул ранжирования.
2. Использование конкретных модулей Drupal 6 и 7 для решения задач поисковой оптимизации.
Как использовать Rapid SQL для ускорения разработки SQL и другого кода для СУБДAndrew Sovtsov
Темы, рассмотренные на вебинаре:
знакомство с командной разработкой, работой с объектами БД
Как происходит отладка ..SQL
Зачем нужны Favorites и закладки
Как увидеть Explain-plans для запросов
Горячие клавиши, шаблоны, подстановка SQL
Как работает Query Builder
5. Веб-технолог должен знать:
— HTML на уровне спецификаций и их особенностей;
— CSS, независимо от цифры, следующей после аббревиатуры;
— JS на предельно хорошем уровне;
— основы типографики;
— английский язык.
6. Углубленный JavaScript — зачем?
— плагины, в большинстве случаев, — зло;
— код нуждается в обслуживании;
— пожелания по скриптам становятся изощреннее от сайта к сайту.
7. Польза от знания английского
— упрощается продумывание классов, названий функций и т.п.;
— код получается более унифицированным, понятным для восприятия;
— исчезают убогие названия, написанные транслитом (novosti_v_stolbik).
8. Развитие творческого мышления
— визуальный анализ макетов перед началом верстки;
— поиск одинаковых / схожих блоков и объединение их в общие
пространства имен;
— продумывание имен классов как сетки, так и всех блоков
(унификация);
— нахождение способов сделать любой элемент (если это возможно и
имеет смысл) как можно более универсальным и независимым от
изменений со стороны клиента или пользователей.
10. Унификация
— код получается читабельным не только для поисковых роботов и
браузеров, но и для людей;
— названия классов / идентификаторов получаются схожими;
— повышается семантичность кода;
— результат получается независимым.
11. Унификация
В представленном коде об унификации
просто-напросто забыли — возникает
ощущение, что над кодом трудились 3
разных технолога.
12. Универсально-независимые блоки
— «боевые» правки (увеличение / уменьшение изображений,
добавление / убавление текста и т.п.) не должны влиять на внешний
вид;
— изменение размеров блока или его родительского блока должно
приводить к масштабированию;
— функциональный блок не должен полностью зависеть от родителя.
13. Из чего состоит код-гайд
— правила, определяющие применение различных тегов в коде;
— правила по присвоению названий классам в тех или иных ситуациях;
— правила по оформлению HTML и CSS, в том числе и CSS-префиксы;
— правила по созданию директорий, именованию файлов.
14. Плюсы работы по код-гайду
— упрощение как коллективной, так и одиночной работы;
— ускорение большинства повторяемых процессов;
— повышение семантичности кода;
— возможность использования кода на последующих проектах;
— код-гайд можно всегда дополнять, совершенствуя его до
бесконечности.
15. Выдержки из код-гайда
Контентные списки (новости, посты
блогов, вакансии и т.п.) называются
следующим образом:
b-namespace-previews
Namespace — класс объектов. Скажем,
для списка блогов — blogs, а для списка
постов блога — blogs-posts.
16. Выдержки из код-гайда
Модификации блоков — это английские
прилагательные, добавляемые после
namespace. В приведенном примере два
списка новостей — обычный и
модифицированный.
17. Выдержки из код-гайда
— директории проекта:
— * assets — вспомогательные файлы (исходники дизайна, спрайтов и т.п., превью для проверки);
— * versions —архивы верстки на разных этапах. Именование — project-name-markup-v.1.zip.
Порядковый номер увеличивается при добавлении новой страницы, в иных случаях
получаются промежуточные версии, например, 1.4.
— i — изображения;
— css — ;-)
— fonts — шрифты для подключения через @font-face;
— js — скрипты.
18. Постоянное развитие
— способы нахождения и безболезненного внедрения новых
технологий и методов без отрыва от рабочего процесса;
— ускорение верстки за счет использования оптимальных методов и
средств;
— искоренение ненужного дублирования кода;
— автоматизация надоедающих этапов работы.
19. Спасибо за внимание ;-)
Нарек Мкртчян
руководитель дизайн-бюро Indentium
— nm@indentium.ru
— twitter.com/gunger
— facebook.com/gunger