DocOps

Тимур Сафин, мой коллега по Тарантулу, прямо сейчас рассказывает про инструменты разработчика в Lua и Tarantool. https://www.youtube.com/watch?v=YlRrciRsyj0

Моя бывшая коллега Катя Говердовская написала хорошую статью про тексты в интерфейсах: https://habr.com/ru/company/plesk/blog/650779/

Поехали!

Прекрасные ребята из подкаста @newpodcast2 зовут меня сегодня пообщаться в эфире. Начало в 18:00 Мск, трансляция будет на ютубе. Пока что собираемся обсуждать такие темы: 1. Конференцию KnowledgeConf, которую мы в этом году проводим вместе с TeamLead Conf. Расскажу про свой опыт работы в программном комитете и про доклад, с которым сам буду выступать. 2. Работу в tarantool.io, новую команду Developer Experience, прежнюю команду документации. 3. Можем в целом обсудить мою странную карьеру, путь из разработки в документацию и обратно. Задавайте вопросы здесь, постараюсь на них ответить :)

Пора уже рассказать вам всю правду. :) С января 2022 я перешёл в команду под названием Developer Experience. Мы делаем инструменты для разработки Тарантула: тестовый фреймворк, инфраструктуру и CI/CD, штуки для исследования производительности, сайт и несколько экосистемных сервисов. Наши пользователи — разработчики, которые делают сам Тарантул, приложения на его основе, экосистемные продукты и документацию. Всё это чертовски интересно. Ещё в прошлом году, когда я стал тимлидом команды документации, у меня появилась куча новых интересных тем, но большинство из них как будто не подходило к тематике этого канала, так что я писал очень мало. Я мог бы совсем забросить этот канал и завести новый, но не буду. Вместо этого буду устранять бессмысленные ограничения. Теперь канал будет не только про документацию и инструменты для неё. Канал будет про всё, что мне интересно в работе. Наконец-то можно будет писать про управление человеками и разработкой, DevOps, Developer Experience, конференции и что угодно ещё. Кайф :)

Читаю книжку про DevOps, там буквально с первых страниц объясняется, зачем всё это. Для бизнеса понятно зачем — чтобы быстро и надёжно разрабатывать и внедрять новые фичи. Кто быстро меняется — лидирует на рынке, кто не может — закрывает бизнес. Но сразу же после этого там пишут про человеческий смысл DevOps. Он в том, чтобы уйти от рабочей системы, которая навязывает людям чувство беспомощности и бессмысленности их работы, принуждает их к конфликту между разными ролями, заставляет их перерабатывать и постоянно тушить пожары. А прийти к системе, которая построена на сотрудничестве, в которой можно спокойно и комфортно работать, постоянно совершенствуя себя, рабочий процесс и продукт. Вот этот человеческий смысл меня очень вдохновляет. По моим наблюдениям, когда люди говорят о DevOps, они часто забывают про этот смысл и редуцируют весь подход до инструментов. «Нам нужен девопс, давайте наймем девопс-инженеров и навнедряем кубернетесов». Ага, а ещё давайте купим дрели и чего-нибудь насверлим. Смысл-то не в инструментах.

Прямо сейчас Артемий Ломов читает студентам лекцию про DocOps и Foliant. Привет! ВНЕЗАПНО образовалась такая штука. Я через 20 минут собрался проводить первое занятие интенсива по DocOps с акцентом на Фолиант в IT-магистратуре МАИ со специализацией на HighLoad-сервисах. И еще более ВНЕЗАПНО материализовалась идея транслировать все это безобразие в Zoom. Ежели есть желающие полюбоваться на этот позор, то велкам: https://zoom.us/j/98566850725?pwd=VEI1VU9aeHhwaGV3Tjg0N1Ayam94QT09 Запись вроде тоже будет.

В чате спрашивают, а бывают ли курсы по DocOps. Курсов нет, но есть кое-что получше, давайте расскажу. Обычно курс по DocOps ищут в такой ситуации: в компании вообще ещё ничего нет и нужно с нуля сделать хорошо, либо есть что-то другое и нужно переделать и переучить людей. И есть один человек, которому больше всех надо и который будет заниматься DocOps-трансформацией. Этот человек будет внедрять новый подход в своей компании на всех уровнях: в инструментах, в процессах, в людях и в принципах работы. Такой человек должен разбираться в документации, локализации, основах разработки и девопса, обучении, управлении проектами и людьми. В идеале ещё публично выступать хоть немного. Исходно никто не умеет сразу вот это всё. И реальность в компаниях на старте очень разная. Поэтому здесь нужен не общий курс, а индивидуальная программа обучения, которая на ходу составляется и меняется под конкретные задачи. В неё войдут разные курсы, книги и практика. А с тем, чтобы собрать всё это вместе, хорошо помогает консультирование и менторство, возможно даже с несколькими менторами по разным направлениям. В этом году я так менторил нескольких человек. Знаю, что у них отличные результаты — ребята, горжусь вами. Так что ответ такой: задача сложная, поэтому курс не поможет — ищите ментора и составляйте индивидуальный план развития. Найти хорошего ментора можно на сайте GetMentor — это такой некоммерческий проект по поиску менторов, там много ребят из IT. И всегда можно просто взять и написать человеку, у которого вы хотели бы поучиться. Я регулярно так делаю :)

В чате «Я шарю» сегодня спрашивали, как лучше начать использовать теги для документов в базе знаний. Сохраню здесь мой ответ. Всё это субъективно и основано на моем опыте использования и модерации StackOverflow, где есть очень четкие правила использования тегов. 1. Тегирование — это живой процесс, вы не сделаете его за один раз и навсегда. Просто начните размечать документы тегами. Смотрите, как люди ими пользуются. Делайте выводы, исправляйте ошибки, добавляйте новые теги, удаляйте ненужные. 2. Отдайте людям возможность добавлять новые теги, удалять ненужные, размечать статьи. Если это будет делать один назначенный менеджер знаний, то результат будет никому не нужен. Чтобы управлять общим процессом, вырабатывайте и доносите людям общие принципы. 3. Категорически не рекомендую сначала заниматься построением полной таксономии/онтологии и картированием знаний. Это очень удобный повод не делать настоящую работу, а вместо неё заниматься бесконечной подготовкой к работе. 4. Не используйте мета-теги: проблема, вопрос, статья, справка, инструкция и тому подобных. Тег описывает тему документа, а не его форму. 5. Не используйте слишком частные теги. Если тег похож на заголовок документа и применим только к нему одному — этот тег идёт в мусорку. Тег должен быть применим хотя бы к 5% документов. (Конкретный уровень вы сами можете установить).

Только что постил ссылку на проект с документацией по вебу. Спасибо читателям, что напомнили: есть документация Mozilla Developer Network, которая лучше и полнее. https://developer.mozilla.org/en-US/

Запустилась Дока — опенсорсная документация по веб-платформе на русском языке. В проекте четыре раздела: HTML, CSS, JavaScript и инструменты. В создании документации может принять любой желающий. Сайт https://doka.guide/ Репозиторий https://github.com/doka-guide/content

Годнота! И хороший вариант чтобы потренироваться и набрать портфолио для начинающих писателей.

Сегодня на #SaintHighLoad2021, на стенде Tarantool. Приходите знакомиться и общаться!

В докладе Алексея Пименова про визуализацию рабочих процессов внезапно появляется управление знаниями. Если мы показываем этап работы как процесс накопления знаний от 0 к 100%, то увидим, как на разных этапах доминируют разные активности. Визуализировать на доске нужно не то, как люди передают работу, а как сменяются доминантные активности. Кажется, у меня уйдет полгода-год на то, чтобы понять всю глубину этой идеи. Хотя бы я теперь об этом знаю. :) И это все ещё #SaintTeamLeadConf

Законспектировал доклад Филиппа Дельгядо про то, как процессы могут попахивать, подобно коду. То есть про конкретные признаки того, что в рабочих процессах есть проблемы, которые пора решать. Самая большая грусть в том, что к некоторым запахам принюхиваешься. Вот так к скраму все привыкли... https://docops-hq.github.io/conf/teamleadconf/21/process-smell/ Это всё на #SaintTeamLeadConf происходит :)

Привет, я сегодня в Питере на TeamLeadConf. Давайте знакомиться, обсуждать доки, управление знаниями и вообще всё что угодно.

А где можно публиковать статьи на английском? Хотим рассказывать про Тарантул международному сообществу. Накидайте площадок, пожалуйста )

Отличная иллюстрация когнитивного искажения, называемого «проклятием знания». https://m.xkcd.com/2501/

На выходных осваиваю планшет, чтобы получше рисовать всякое для наших командных семинаров. Здесь первая строка написана мышкой, вторая — с планшета. Мне нравится, что получается. Удобнее, чем мышкой, и душевнее, чем просто текст напечатать.