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

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

В чате «Я шарю» сегодня спрашивали, как лучше начать использовать теги для документов в базе знаний. Сохраню здесь мой ответ. Всё это субъективно и основано на моем опыте использования и модерации StackOverflow, где есть очень четкие правила использования тегов.

1. Тегирование — это живой процесс, вы не сделаете его за один раз и навсегда. Просто начните размечать документы тегами. Смотрите, как люди ими пользуются. Делайте выводы, исправляйте ошибки, добавляйте новые теги, удаляйте ненужные.

2. Отдайте людям возможность добавлять новые теги, удалять ненужные, размечать статьи. Если это будет делать один назначенный менеджер знаний, то результат будет никому не нужен. Чтобы управлять общим процессом, вырабатывайте и доносите людям общие принципы.

3. Категорически не рекомендую сначала заниматься построением полной таксономии/онтологии и картированием знаний. Это очень удобный повод не делать настоящую работу, а вместо неё заниматься бесконечной подготовкой к работе.

4. Не используйте мета-теги: проблема, вопрос, статья, справка, инструкция и тому подобных. Тег описывает тему документа, а не его форму.

5. Не используйте слишком частные теги. Если тег похож на заголовок документа и применим только к нему одному — этот тег идёт в мусорку. Тег должен быть применим хотя бы к 5% документов. (Конкретный уровень вы сами можете установить).

В чате спрашивают, а бывают ли курсы по DocOps. Курсов нет, но есть кое-что получше, давайте расскажу.

Обычно курс по DocOps ищут в такой ситуации: в компании вообще ещё ничего нет и нужно с нуля сделать хорошо, либо есть что-то другое и нужно переделать и переучить людей. И есть один человек, которому больше всех надо и который будет заниматься DocOps-трансформацией.

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

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

Так что ответ такой: задача сложная, поэтому курс не поможет — ищите ментора и составляйте индивидуальный план развития. Найти хорошего ментора можно на сайте GetMentor — это такой некоммерческий проект по поиску менторов, там много ребят из IT. И всегда можно просто взять и написать человеку, у которого вы хотели бы поучиться. Я регулярно так делаю :)

Читаю книжку про DevOps, там буквально с первых страниц объясняется, зачем всё это. Для бизнеса понятно зачем — чтобы быстро и надёжно разрабатывать и внедрять новые фичи. Кто быстро меняется — лидирует на рынке, кто не может — закрывает бизнес.

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

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

Пора уже рассказать вам всю правду. :)

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

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

Теперь канал будет не только про документацию и инструменты для неё. Канал будет про всё, что мне интересно в работе. Наконец-то можно будет писать про управление человеками и разработкой, DevOps, Developer Experience, конференции и что угодно ещё.

Кайф :)

Прекрасные ребята из подкаста @newpodcast2 зовут меня сегодня пообщаться в эфире. Начало в 18:00 Мск, трансляция будет на ютубе.

Пока что собираемся обсуждать такие темы:

1. Конференцию KnowledgeConf, которую мы в этом году проводим вместе с TeamLead Conf. Расскажу про свой опыт работы в программном комитете и про доклад, с которым сам буду выступать.
2. Работу в tarantool.io, новую команду Developer Experience, прежнюю команду документации.
3. Можем в целом обсудить мою странную карьеру, путь из разработки в документацию и обратно.

Задавайте вопросы здесь, постараюсь на них ответить :)

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

Тимур Сафин, мой коллега по Тарантулу, прямо сейчас рассказывает про инструменты разработчика в Lua и Tarantool.

https://www.youtube.com/watch?v=YlRrciRsyj0

Мы ищем ещё одного техписателя в tarantool.io.

Тарантул — один из немногих успешных и известных опенсорсных продуктов из России. Все исходники документации лежат на гитхабе, их большая часть — в публичных репозиториях, так что это отличный способ наработать портфолио, которое потом можно будет показывать всему миру.

Мы пишем в Sphinx & reStructuredText, разработка документации очень хорошо инструментирована, инструменты постоянно развиваются. В прошлом году у нас был выделенный разработчик для доки, а теперь есть целая команда, которая занимается инструментами для разработчиков. Техписателей мы тоже считаем разработчиками, только документации.

Рабочий макбук, монитор на 4к, лицензия на Grammarly, среду разработки, Docker Desktop и всё остальное, что нужно. Можно работать в офисе в Москве, можно работать удаленно, можно чередовать, условия оплаты совершенно одинаковые для Москвы и не-Москвы. В целом команда распределенная, так что работать на удаленке комфортно.

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

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

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

Пишем на английском, так что нужен сразу хороший навык. Пишем про базы данных и программирование, темы хардкорные, лучше если вы с таким уже работали. Работа только в git/GitHub/Sphinx/Docker; если уже умеете — круто, если нет — поможем научиться.

С вопросами и резюме приходите в личку @Nick_Volynkin

Сегодня общались с сибирским QA-сообществом @qa_siberia. Говорили про Тарантул, его тестирование и тулинг, роль команды Developer Experience во всём этом.

Ссылка на запись: https://www.youtube.com/watch?v=JJ7UaS4qun0

Мы делаем свою летнюю студенческую стажировку в Тарантуле. Приходите и рекомендуйте знакомым студентам, у нас круто.

Команда Tarantool открыла набор на студенческую программу для работы над исследовательскими задачами

Студенческая программа Tarantool целиком состоит из практики разработки. Старт запланирован на 1 июля. В первую неделю менторы из числа сотрудников Tarantool познакомят участников с проектом и технологиями, а студенты смогут выбрать задачи, с которыми им предстоит работать — средней или повышенной сложности.

Решать задачи можно в одиночку или в команде. На задачи средней сложности отводится два месяца, на более сложные — четыре. Разобраться с вопросами и трудностями, возникающими в процессе, поможет ментор. После успешного выполнения участники получат вознаграждение: 120 или 240 тысяч рублей, в зависимости от сложности задачи.

Кандидатам нужно зарегистрироваться, заполнив форму. Участники программы будут отобраны в конце июня 2022 года.

Я сегодня на TeamLead Conf, буду рассказывать про коммуникации внутри и вне компании. Если вы тоже здесь, приходите в Аврору к 11:20!

В следующую среду 1 июня Николай Поташников на конференции Heisenbug сделает доклад о своем опыте применения DocOps. Приходите послушать Николая!

Друзья мои, а кто будет завтра на CodeFest? Приходите общаться про доки, разработку, управление знаниями и всё что угодно. Я буду где-нибудь около стенда VK.

Совершенно внезапно буду вести на CodeFest квартирник про деньги и документацию. Если вы здесь — приходите поговорить про стоимость и выгоду технических коммуникаций: доки разных видов, статей, курсов и докладов на CodeFest. Деньги считать сложно, но мы попробуем сделать это вместе. Квартирник будет сегодня в 11:00, это буквально через 15 минут.

Квартирник закончился, но разговор продолжается, мы даже половины вопросов не обсудили ещё. Продолжим в онлайне после конфы?

Выступать — это не больно, проще, чем вы думаете и можно даже джуну. Выступать можно на техтолке в своей компании, на митапах и на прекрасных конфах вроде CodeFest. Сегодня в 16 часов мы соберемся и поговорим про это на еще одном квартирнике.

Эти прекрасные люди придут, чтобы сказать лично вам, что вы норм, у вас есть интересные темы и вы сделаете хороший доклад:

— Света Михайлова, за конференцию CodeFest.
— Алексей Мерсон, за DotNext и ArchDays.
— Ник Волынкин, за KnowledgeConf и Write the Docs.
— Алексей Пименов, за KanbanEurasia, AgileDays и личный опыт.
— Виталий Шароватов, за всех подготовленных докладчиков и личный опыт.

Приходите в 16:00 в зону квартирников на втором этаже.

Всех, кто не на конфе, но хотел бы прийти — обнимаю. Для вас мы это еще в онлайне повторим, возможно и не раз. :)

Приехала моя прелесть.

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