Всем привет!

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

Часть 3. Неожиданная обратная связь

Получив неожиданную задачу, заместительница руководителя (Рената) пыталась достучаться до лида группы, но ничего не получалось — он отдыхал в другой стране и не отвечал. Нужно было брать всё в свои руки.

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

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

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

Когда через неделю из отпуска вернулся руководитель отдела, он подключился к общей работе. Пенелопа воодушевилась: руководитель похвалил их самостоятельность, план и сплочёную работу. Она решила, что это лучшее место работы, которое может быть, пока ей не пришло приглашение на встречу «1–1».

Руководитель сказал, что на этой встрече они дадут друг другу обратную связь: как работается, что нравится и не нравится. И попросил девушку подготовиться. Пенелопа испугалась — раньше у неё таких встреч не было. Девушка начала себя накручивать: вдруг эта встреча означает, что она плохо работает и её увольняют ещё до окончания испытательного срока?

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

#невыдуманныеистории #Пенелопа_ищет_икигай

#мемница

«Главное в расследовании — не выйти на самого себя»

#писалитирекомендует
Всем привет!
Недавно познакомились с ребятами, которые пишут в блог IT-компании Reactive "Проспал планëрку". У них вышел интересный материал про техписателей.
Делимся😊

#флешмобити

Друзья, предыдущий пост оказался довольно резонансным) И навёл нас на мысль: а не устроить ли нам флешмоб?

Расскажите в комментариях, как обычно проходит ваш рабочий день✍️ Ведь на вкус и цвет фломастеры техписатели такие разные!

#писалитирекомендует

Всем привет!
Совсем скоро пройдёт Первая Международная конференция технических писателей TechWriter Days — 5-6 апреля 2024 в Москве. Мероприятие состоится в гибридном формате - офлайн + онлайн-трансляция.

2 дня, 3 параллельные секции, 50+ докладов и мастер-классов — участники обсудят актуальные темы, тенденции и лучшие практики в области создания технической документации и коммуни️кации в технических сферах.

Доклады ориентированы на разный уровень подготовленности участников.

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

Подробнее об этих и других выступлениях - на сайте конференции.

💥 Бонус для подписчиков — скидка 15% на билеты по промокоду PISALITY.

Для удобства ссылки даём отдельно:
• билеты
• программа
• контакты организаторов.

P.S. На этой конференции Семён Факторович представит результаты большого исследования, которое его команда проводила с начала года.
Обращайте внимание на уровень аудитории доклада.
P.P.S. Школа Техписалити! в лице одного из админов участвовала в программном комитете конференции.

#практика

UPD: задание улетело, как горячий пирожок😉
Ну, не унывайте, ещё найдется)

Прошу минутку внимания!)

Начинающие техписы, которые бы хотели сконтрибьютить в опенсорс, отзовитесь)
Есть автор одной утилиты, который бы не отказался от помощи в написании небольшой инструкции) но сроки чуть поджимают)
Писать мне (Лиде) в личку @litulyagan

#писалитирекомендует

Всем привет!

18 апреля в 19:00 X5 Tech проведёт в Москве четвёртый Techdoc Meetup! В программе доклады на актуальные темы: использование ИИ, выстраивание процессов и даже... личных границ! А завершится всё ставшим уже традиционным круглым столом.

Мероприятие будет проведено очно. Подробности, билеты и программу митапа ищите тут ✍️

А для тех, кто не сможет присутствовать лично, будет трансляция на YouTube 🎥

#такбывает
Всем привет!

Зафиксирован случай контрибуции техписателя в документацию опенсорсного продукта!

Недавно мы искали желающего, кто может срочно помочь разработчику. Техписатель-джун Полина Клименко согласилась помочь и написала инструкцию для утилиты mdis, которая позволяет "вытаскивать" актуальные примеры из кода.

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

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

А ещё это наша первая публикация в телетайп. Ставьте реакции, если формат зашёл!

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

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

Но на самом деле все онбординги вариативны и зависят от команд и их потребностей.

#средаразработки

лже-#мемница

Сказ о том, как три филологические девы стали техножрицами... или who is who)🧐

Всем привет!

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

Лида - технический писатель Wildberries (между прочим, первый представитель этого редкого вида в корпорации!), амбассадор WB в белгородских вузах, а также идейный вдохновитель этого канала! У нее за плечами 20 лет опыта работы с текстами, из которых 9 - в журналистике. А теперь Лида знает не только как в одиночку развернуть документацию с нуля (на минуточку, используя docs-as-code!), но и как собеседовать и нанимать техписателей. Прочитать о том, как Лида пришла в техписательство, можно здесь.

Маша - технический писатель Ozon (да-да, работа в соперничающих корпорациях дружбе не помеха!). Профессиональный редактор, мечтавший когда-то стать программистом. Под её руководством одно из крупнейших издательств страны выпускало детские книги, среди которых - крутой сборник головоломок! А сейчас Маша не только пишет внутреннюю документацию для разработчиков, но ещё придумывает новые рубрики и виртуозно создаёт большинство мемов для этого канала. О том, как Маша стала техписателем, читайте тут.

Катя - технический и UX-писатель Лаборатории Касперского. В прошлом переводчик в нефтегазовой отрасли, теперь создает пользовательскую документацию для b2c и b2b продуктов, а также работает с текстами интерфейсов (аж на целых двух языках!). В этом канале отвечает за языковое разнообразие. О карьерном пути Кати читайте здесь.

Все трое начали карьеру техписателей в одном из подразделений VK. С тех пор наши профессиональные пути немного разошлись... но мы по-прежнему вместе и пытаемся быть полезными для сообщества технических писателей и для тех, кто только собирается к нему присоединиться)

В комментариях расскажите о себе... а может даже о том, как тут оказались!✍️

P.S. А ещё нашему каналу недавно исполнился целый один год! Спасибо, что вы с нами! 🩵