Мотивация, делегирование и автоматизация: рецепт создания суперкоманды.

Алексей Катаев из Skyeng прочитал классный доклад про то, как тимлиду уменьшить количество ада и боли в своей работе. Во многом это близко к практикам управления знаниями: как улучшить автобусный фактор и научить каждого разработчика решать задачи, которые раньше мог делать только тимлид. А ещё напоминает историю из книги Проект Феникс: когда вокруг всё горит, как начать предотвращать пожары и перестать их постоянно тушить.

https://github.com/NickVolynkin/teamleadconf-19/blob/master/source/superteam.md

Напомню, что мы делаем конференцию про управление знаниями KnowledgeConf. Докладчики расскажут:
— что делать с автобусным фактором,
— как учить людей решать задачи,
— как найти и нанять людей, которые учатся сами.

Управление знаниями в проектных командах.

Мы тут проводим митап от программного комитета KnowledgeConf. В первой половине записали плюсы и минусы разных подходов к документации и тому, как сохранять знания о проекте. https://github.com/NickVolynkin/teamleadconf-19/blob/master/source/km-meetup.md

Мы тут собрали истории про адовый адъ, страшный сон и былинный провал в документации и управлении знаниями. Помогите выбрать лучшую!

t.me/KnowledgeConfChannel/14

CodeFest: Три истории провалов с Git.

Привет! Впереди конференция CodeFest. Там на стенде компании Plesk будут небольшие доклады от наших ребят. А я хочу провести там воркшоп о проблемах с Git.

На воркшопе обсудим несколько неочевидных ошибок, почему они происходят, как их решать и предотвращать. Расскажу немного про то, как внутри устроены коммиты. Решим несколько практических задачек, получим немного боевого опыта факапов и их починки. В конце вместе пособираем коммиты голыми руками: без использования git, только через Python/Ruby REPL.

Расскажите, стоит ли вообще это делать, придёте ли вы лично?

DocOps на CodeFest.

Похоже, что воркшоп про Git лучше провести отдельно. По-хорошему там на полтора часа, а у нас было бы всего 30 минут.

Зато мы с Семёном @factorized Факторовичем проведем на Кодфесте квартирник про DocOps. Точное время пока не знаю, но обязательно напишу позже. Приходите! Вопросы и темы можно заранее накидывать в чате @docsascode.

А ещё у меня сегодня день рождения, мне внезапно 33.

Спасибо, что вы все были в моей жизни в этот год. В следующем всё будет ещё интереснее. Будет конференция, курс назревает, новые встречи и проекты. До встречи где-нибудь! Пишите на @nick_volynkin, договоримся.

Если хотите меня поздравить, можно скинуть денег на карту. Я добавлю и куплю монитор, чтобы бодрее писать посты и конспекты.

5536 9137 8952 4200

Искренне ваш, Ник Волынкин. :)

Роль и польза техписателей в Plesk.

Мы всей компанией готовимся к Кодфесту. Я сегодня написал несколько абзацев про команду техписателей для нашей общей статьи про компанию. Постарался объяснить, зачем мы вообще нужны и в чём польза. Хочу узнать ваше мнение о том, что получилось.

Технические писатели в Plesk отвечают за технические коммуникации компании с пользователями: документацию, release notes, тексты в интерфейсе и блоги.

Мы разрабатываем документацию по всем нашим продуктам. Документация помогает пользователям осваивать продукты и самим решать свои задачи, а компании помогает продавать продукты и тратить меньше денег на поддержку.

Также мы работаем над текстами в интерфейсе и вместе с дизайнерами улучшаем UX. Чем понятнее интерфейс, тем меньше пользователей потратят время технической поддержки или пойдут пробовать продукт конкурентов.

А ещё мы рассказываем про обновления продуктов в release notes. Их главная задача — мотивировать пользователей скорее обновляться к новой версии, в которой есть нужные им фичи и исправлены затронувшие их баги. Чем быстрее пользователи обновляются, тем меньше у них проблем и лучше впечатление от наших продуктов.

В блоги компании на русском и английском языке пишут все сотрудники. Техписатели помогают им редактурой, особенно для текстов на английском.

Что здесь понятно, что непонятно? С чем вы хотели бы поспорить? Напишите мне на @nickvolynkin или в чат @docsascode.

​​Программа KnowledgeConf готова!

Программа конференции по управлению знаниями KnowledgeConf готова. Мы выбрали 24 лучших доклада из 83 заявок. Прямо сейчас докладчики активно работают над своими докладами, а мы будем вам о них рассказывать.

Лана Новикова написала статью-анонс: KnowledgeConf: нам нужно серьезно поговорить о докладах. Читайте, ставьте плюсы и, конечно, приходите на конференцию.

На фото мы с Ланой общаемся с участником TeamLeadConf на стендe нашей конференции.

Кто-нибудь выгружает описания API в OpenAPI (swagger) из кода на Java? У вас есть тесты на полноту javadoc'ов? Поделитесь опытом в @docsascode, пожалуйста.

Если вы сегодня на CodeFest — приходите к нам на квартирники. Первый будет в 10:50, тема — «Почему технический писатель — не аналитик».

https://2019.codefest.ru/lecture/1512

Второй квартирник на CodeFest: «Можно ли превратить создание и поддержку документации в процесс, или что такое DocOps».

14:10, то есть прямо сейчас.

https://2019.codefest.ru/lecture/1511

Через час (17 по Новосибирску, 13 по Москве) мы с Семёном Факторовичем и Татьяной Фокиной будем рассказывать про документацию и DocOps на радио ЦФТ. Трансляция тут: https://team.cft.ru/radio

Командный и персональный рост в продукте: уроки, навыки и процессы.

А вот и первый конспект с Кодфеста!

Анна Бояркина из Miro (ex-RealtimeBoard) рассказывает, что компания может расти экспоненциально, а сотрудники — только линейно, и как помочь сотрудникам успевать за быстрорастущей компанией.

​​Эволюция цифрового общения.

Виктор Иванов из ВК рассказывает, как 23 года назад появилось цифровое общение, как оно менялось и меняло весь мир коммуникаций.

https://github.com/plesk/codefest19/blob/master/source/digital-communication.md

Уже пару конспектов прервал на середине: трансляция не позволяет нормально досмотреть доклад.

К сожалению, на сегодня всё. Ждите продолжения конспектов на Highload.

Если вы сейчас на CodeFest — приходите в 17:00 на доклад Сергея Быстрых:«Как ускорить тесты в 10 раз и вернуть к ним доверие». Там реальная история оптимизации тестов, которую я наблюдал своими глазами в Plesk (хоть и со стороны).

https://2019.codefest.ru/lecture/1419

Технические задания как исполняемый код.

На обоих вчерашних квартирниках на CodeFest мы упоминали Gherkin. Это язык для формального описания требований, которые потом можно выполнять как автотесты.

Если вам это интересно — почитайте статью Никиты Соболева про то, как писать требования: Engineering guide to writing correct User Stories.

​​На честном слове и на одном ядре.
Генератор статических сайтов Jekyll — однопоточный. Даже если на машине прекрасные 8 или 16 ядер, Jekyll всё равно использует одно ядро для сборки доки. Поэтому у меня сейчас этап сборки на Jekyll длится по 15-20 минут.

Если у вас в документации тысячи страниц — берите сразу многопоточный генератор.

Jekyll → Hugo.

Читатель подсказывает, что с Jekyll надо переходить на Hugo, у которого всё хорошо со скоростью. Вот инструкция:Migrating from Jekyll+Github Pages to Hugo+Netlify.

Объединить конспекты всех конференций в один репозиторий или каждую писать в новом? Как вы считаете, что будет лучше?

Раньше писал в разных:
— Highload 2018
— TeamLeadConf 2018
— CodeFest X

Аргументы за разные: проще структура, не смешивается в кучу.
Аргументы за один: всё в одном месте, легче сделать сайт.