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

Команда 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 в зону квартирников на втором этаже.

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

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

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

Можно зарегистрироваться на бесплатный онлайн-день и послушать доклад Николая. Регистрация здесь: https://heisenbug.ru/registration/personal/

Кто поставил дизлайк — а расскажите, за что? Вы против бесплатных билетов или в целом против конференций? Можно в личку @nick_volynkin

С утра нашёл прекрасное 1x.engineer

Комикс про зоопарк систем для управления личными знаниями от https://www.instagram.com/innubis/ прям в самое сердечко ❤️

Кто прод шатает по утрам,
Тот поступает мудро.
Тарам-парам-тарам-парам,
На то оно и утро!

Интересная у меня работа сейчас. В ней есть немного разработки, тестирования и DevOps. Документацию пишу регулярно, правда не для внешних пользователей, а для своих же. Большая часть работы про что-то вроде управления продуктом, где продукт — это платформа и инструменты для разработчиков. Есть планирование и декомпозиция задач. Есть дизайн-ревью технических решений. Наконец, есть работа с командой: цели, развитие, мотивация, вот эти все прекрасные штуки. Не работа, а мечта.

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

А в вашей работе что самое сложное?

«Не бывает задач, над которыми вредно думать»

С утра пораньше пересматриваю доклад Фила Дельгядо про дизайн-ревью. Суть практики в том, чтобы перенести ревью пораньше к началу задачи:
— Раньше обдумывали решение в процессе работы, а ревью делали на готовом коде. А потом переделывали, потому что решение неверное.
— Теперь обдумываем дизайн решения, сразу ревьюим его, а потом пишем код. Меньше переделываем, больше радуемся.

Хорошая практика, рекомендую хотя бы познакомиться и обдумать. Тестировщики узнают в этом shift left. Для документации это точно так же применимо: можно обдумать место и структуру для будущей доки. В Тарантуле мы часть этой работы делаем в процессе триажа задачи.

https://youtu.be/4Y0XJXRZv6k

Максим Лапшин рассказывал про API-first подход на недавнем TechLead Conf. Это, пожалуй, самое полезное, что можно послушать про OpenAPI, потому что Максим объясняет смысл и суть документирования API. А уж как это делать технически, можно прочитать в документации и куче статей, и это не так важно.

Этот доклад здорово перекликается с рассказом про Design Review от Фила Дельгядо — я писал о нём в прошлом посте. Рекомендую смотреть оба в любом порядке.

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

(Всего месяц прошел с конфы, ссылка публикуется впервые с разрешения Максима, эксклюзив и контрабанда!)

Писать в документации «мы» — довольно фиговая практика. Непонятно, кто это. Мы, которые писали код? Мы, которые писали доки? Мы с читателем (щас на пару тут пройдем туториал)?

Хуже этого только «мы» в логах и API. Вот прямо сейчас я смотрю на We are completely uploaded and fine, а после этого ответ 502. Нет, мы не fine, совсем не fine.

Из менторской сессии. Бывают вот такие диалоги:
— Чувак у нас сарай горит!
— «Чувак» это обращение, после него нужна запятая!

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

— Мы как будто сегодня докапываемся до того, как держим вилку и нож, а вчера мы ели людей и это никого не беспокоило.

А что у вас в сообщениях коммитов и описаниях пулл-реквестов? Пишете как попало? Соблюдаете сотню правил и пишете многостраничные тексты? Что-то среднее? Расскажите :)

Подкаст про DocOps для аналитиков

Николай Поташников позвал меня поговорить про документацию и DocOps для аналитиков в подкаст Flow Live. Спикеры очень клёвые и разные, я даже не со всеми знаком, самому очень интересно.

А пока что накидайте вопросов и тем, пожалуйста. Особенно если вы системный/бизнес/другой аналитик. Что вам интересно, про что хотите услышать, что у вас болит в документации?

Сказать в подкасте, что мы все умрём и это нормально — сделано ✅

В целом, мне нравится, что у нас получилось. Посмотрите: https://youtu.be/ok9KMRCbrq8