DocOps

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

5536 9137 8952 4200

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

DocOps на CodeFest.

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

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

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

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

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

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

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

t.me/KnowledgeConfChannel/14

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

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

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

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

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

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

​​Работа со сроками как часть инженерной культуры.

Николай Крапивный из Badoo рассказывает, как правильно оценить время на выполнение задачи, выставить срок, работать по нему и делать выводы.

Если кратко, Николай предлагает отдать разработчикам всю работу со сроками и ответственность за них. Если вам кажется, что это просто скидывание ответственности с тимлида, почитайте конспект до конца. Всё не так уж плохо и даже, пожалуй, лучше, чем когда сроки скидывают сверху.

https://github.com/NickVolynkin/teamleadconf-19/blob/master/source/time-is-culture.md

​У нас есть стенд имени себя — на нем непрерывно выдаются подарки и рассказывается обо всех конференциях Онтико.

Выкладывайте конспекты (в любом удобном виде) в одну из соцсетей с хэштегом #TeamLeadConf2019, с результатом подходите к стенду — получите кружку.

Со стикерпаком еще проще — его дают за любой пост с #TeamLeadConf2019

Шлите ваши конспекты пуллреквестами в https://github.com/NickVolynkin/teamleadconf-19!

За это тоже кружки дают. А ещё на гитхабе их очень хорошо читают: у конспектов Highload в первые недели было больше тысячи посещений в день. Так что польза будет максимальная.

​​Конспекты TeamLeadConf 2019.
Если начал писать конспекты, сложно остановиться. Так что на TeamLeadConf я снова этим занимаюсь. Шлите пуллреквесты!

OKR: инструкция по применению.

Первый доклад этой конференции. Егор Толстой рассказывает о трёхлетнем опыте внедрения Objectives & Key Results в компании Авито. Егор даёт очень много практических примеров и разбирает типичные ошибки и заблуждения. И, конечно, там есть пошаговая инструкция по внедрению.

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

​​— Что у вас болит в документации?
— Её нет.
— Фантомные боли!

Сегодня на стенде documentation doctors работают Семён Факторович, Николай Поташников и Константин Валеев.