Привет! Новый опрос про деврел готов.

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

Даже если вы занимаетесь деврел не 100% рабочего времени, а совмещаете с другим направлениями — этот опрос тоже для вас.

Опрос открыт до 14 ноября.
Время прохождения: 15-30 минут.
Результаты исследования за 2021 год смотрите тут.

Мы все заинтересованы в максимальном охвате, поэтому заполняйте опрос сами и отправляйте его коллегам и конкурентам.

Ссылка на опрос.

Женя Голева каждый год проводит опрос специалистов, чья работа относится к Developer Relations. Обязательно поучаствуйте, даже если это не ваша основная работа, а вы просто пишете статьи или собираете митапы в свободное время. И на канал подпишитесь. :)

Я настолько зол, что напишу пост не по теме. Onetwotrip не вернули мне деньги за возврат билета. Сначала полтора месяца типа рассматривали заявку, а потом прислали письмо, на которое нужно было срочно ответить, чтобы заявку не отменили. Мудилы, не иначе. Поддержки в приложении нет, можно только звонить и висеть в очереди в колл-центре. Сервис — говно.

Короче, не покупайте у них билеты, не приходите к ним работать, пусть они обанкротятся к чертям. :)

Вернем канал в техническое русло. Сегодня в пятидесятый раз делился любимым алиасом для гита. Поделюсь и с вами.

$ git config --global alias.lg \
    "log --color --graph --abbrev-commit --all \
    --pretty=format:'%Cred%h%Creset -%C(yellow bold)%d%Creset %s \
    %Cgreen(%cr) %C(blue)<%an>%Creset'"

$ git lg

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

А что, есть ли у меня читатели из Бишкека? Я буду там в воскресенье. Пойдем пить чаек и разговаривать о работе? Напишите в комментариях или в личку @nick_volynkin.

В эту среду будем обсуждать DocOps в работе системных аналитиков на конференции Flow. Собираемся прекрасной компанией, я всех этих людей очень ценю и уважаю, но вместе мы все ещё, кажется, не собирались: Лана Новикова, Семён Факторович, Константин Валеев, Николай Поташников, ну и автор этого канала Ник Волынкин. Если вы будете на конференции — приходите слушать нас в среду в 16:45 Мск.

Если у вас нет билета, но вы вдруг решите его купить прямо сегодня, держите прокомод на -20%: DocOps2022JRGpc.

Сегодня сообщество пользователей Foliant празднует два года своего существования. Поздравляю авторов и сообщество, спасибо вам за классный инструмент (который я сам не использую, но регулярно рекомендую).

В честь дня рождения сегодня вечером планируются кухонные онлайн-посиделки. Заходите в https://news.1rj.ru/str/foliantdocs, там будет ссылка на звонок.

Уточню: это сообществу два года, а сам Foliant старше еще года на два.

The GOVNO framework is a novel approach to project management that aims to improve upon the shortcomings of the popular scrum methodology. Each letter of the acronym represents a key aspect of the framework:

— Governance
— Objectives
— Visibility
— Networks
— Outcomes, not outputs

https://govno.works/

Шедевр же )

Нейросети отбирают работу у специалистов по Developer Relations :)

Нашёл образец фиговой документации.

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

Сижу на встрече с докладчиками дружественной конференции FrontendConf. Среди тем есть управление знаниями и всё что вокруг него. Классно, что ребята тоже это ценят и понимают важность. Если вам есть что рассказать про онбординг, профессиональный рост, документацию и сообщества во фронтенде — скорей подавайте заявку. https://cfp.frontendconf.ru

Зачем учить AI писать документацию, когда можно научить AI читать документацию, и он будет отвечать на произвольные вопросы пользователей

https://githubnext.com/projects/copilot-for-docs

Расскажите про IT-сообщества и всякий движ в Армении и Грузии? Что там по митапам и конференциям? Хочу совместить приятное с полезным: познакомиться с вами, выступить с каким-нибудь полезным докладом, посмотреть на страну, поесть вкусной еды.

Если вам удобнее голосом — давайте созвонимся и обсудим за утренним кофе. Букайте встречу. :)

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

Каналы про тимлидов и про коммуникации.
Телеграм только что выкатил новую фичу: теперь папками из телеграма можно делиться. Я взял свои папки про тимлидство и про технические коммуникации (доки + управление знаниями + деврел), убрал из них 1-1 и закрытые чатики, и вот что получилось.

TeamLead: https://news.1rj.ru/str/addlist/l5DYX3mRhwtiYWU6

DocOps: https://news.1rj.ru/str/addlist/3GI1i-KgDPI3ODli

Если не работает — обновите приложение :)
Подборки полностью субъективны, я наверняка что-то хорошее пропустил, так что фидбек и предложения принимаю. Пишите комменты )

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

Инструкция колд-брю — идеальный напиток для человека, который пишет инструкции.

Developer Relations и как я к этому пришел.

Пора рассказать, что я теперь делаю. С февраля я работаю в =nil; Foundation, мы делаем инструменты для разработчиков. Про компанию расскажу отдельным постом, пока что про себя. Я тут занимаюсь developer relations. Сейчас объясню, что это за штука такая.

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

Теперь сделаем “unfold”, развернем одно из ограничений. Будем писать не только документацию, а еще статьи в блог, учебные задачки с подробным объяснением и разные другие текстовые форматы. Мы же умеем хорошо писать, зачем ограничиваться документацией, другие форматы тоже могут решать нашу задачу.

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

Потом оказывается, что иногда текст воспринимается плохо, надо рассказывать и показывать. Мы с вами тренируемся это делать, осваиваем всякие комбинированные форматы: выступления, воркшопы, курсы, live coding всякий, тренинги. Теперь наша с вами специальность — технические коммуникации, а инструментов у нас много и мы их подбираем под конкретную задачу и аудиторию.

К этому этапу работы уже так много, что в одиночку ее никак не сделать, появляется команда. Можно пойти в тимлиды, можно остаться линейным сотрудником в команде. Все варианты хороши.

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

>>> Вы находитесь здесь <<<

Всё это в индустрии называется developer relations и этим я занимаюсь. Нас в команде двое, прямо сейчас есть вакансии на еще двоих: technical writer и developer advocate. Я напишу пост про вакансии на этой неделе, но если вам уже интересно, пишите в личку @nick_volynkin прямо сейчас.