Всем привет!
Нас зовут Лида, Маша и Катя, и мы технические писатели)

Этот пост — навигатор по каналу. Переходите по тегам и читайте то, что вам нужно.

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

Впереди ещё много тем и новых рубрик. Учитесь с нами)

Всем привет!

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

Суть: у нас есть персонаж, и мы описываем некоторую ситуацию из жизни. Затем проводим опрос, что персонаж должен сделать и, отталкиваясь от ответов, развиваем сюжет.

Часть 1. Пенелопа меняет профессию

Пенелопа несколько лет работает аккаунт-менеджером в небольшой компании. Она чувствует, что близка к выгоранию, но сделать с этим ничего не может. Где бы она ни работала аккаунтом, меньше стресса, звонков и времени, когда нужно быть на связи, не будет. Также ей надоело, что у неё нет нормального work-life balance: желательно быть на связи вечером, в выходные и даже в отпуске.
Пенелопе это всё надоело, и она решила сменить работу на менее стрессовую и менее зависимую от клиентов. Чтобы видеть результат своей работы, а также приносить пользу другим людям. А вишенкой на торте — получать больше денег.
Посмотрев на рынок труда, она увидела привлекательную профессию — технический писатель. Изучив, кто это такой, ей показалось, что это человек, который сидит в тишине, пишет инструкции для пользователей и никто его не трогает. Она тоже писала инструкции для своих клиентов и обучала их работе с системой. Девушка подумала, что это оно.
Пенелопа почитала рекомендации, обновила и выложила своё резюме. В нём она указала, что умеет работать с большим количеством информации, писала инструкции для клиентов, умеет в коммуникации и может сопровождать небольшие проекты.
Девушка начала откликаться и временами проходить собеседования.

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

Всем привет!

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

Часть 2. Пенелопа делает первые шаги

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

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

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

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

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

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

Всем привет!

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

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

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

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

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

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

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

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

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

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