О чём пишет технический писатель?

Часто говорят, что технический писатель — это переводчик с разработческого на человеческий. Но разработчики — люди, а технический писатель делает намного больше, чем просто переводит, поэтому такая формулировка звучит довольно обидно. Для обеих сторон. Обсудили это и многое другое с техническим писателем Мариной Вашак

Что за профессия

Технический писатель создаёт техническую документацию. Это могут быть инструкции для пользователей — например, разделы «Помощь» или FAQ на сайтах. А также сугубо технические спецификации, больше ориентированные на разработчиков или нужные для регистрации ПО в Росреестре.

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

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

Описание миграции данных

Какие знания и навыки нужны

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

Я по образованию журналист. И считаю, что диплом сыграл в мою пользу, потому что:
— умею работать с текстами;— знаю, как брать интервью и превращать его в интересный рассказ;
— умею добывать и обрабатывать информацию.
Марина Вашак, технический писатель

Вот чем будет полезно техническое образование:

— технический склад ума и системное мышление — отличные спутники в IT-сфере;

— навыки программирования помогут понимать разработчиков;

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

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

Есть и базовый набор умений, которые не зависят от образования, но сильно упростят техпису жизнь:

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

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

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

  • Умение писать коротко и по делу. Технический текст должен быть сухим, без лишних расшаркиваний. Техпис не гонится за количеством слов — наоборот, снимает с текста все «украшения»: обособленные обороты, составные глаголы, отглагольные существительные и прочую мишуру.

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

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

Artboard

Как понять, что работа мне подходит

Возьмите приложение любимого банка и напишите инструкцию к какому-то простому процессу. Например, как оплатить мобильную связь. Покажите эту инструкцию друзьям или родителям, попросите проверить и попробовать пополнить баланс, следуя ей. Если инструкция сработала — поздравляю, это прекрасный старт, вы готовы к тестовым заданиям.

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

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

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

Ещё есть чаты увлечённых техписательством людей. Можно проникнуть туда, чтобы посоветоваться, попросить вычитать текст или дать ОС. Там и вакансии периодически публикуют.

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

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

Как научиться писать понятные инструкции

  • Много писать — дневники, посты в соцсетях, каналы в «Телеграме».

  • Читать — любую литературу: научпоп, художественную, научную.

  • Развивать насмотренность. Изучайте инструкции к продуктам, которыми пользуетесь: банковским приложениям, сервисам доставки, такси, мессенджерам. Как они написаны, в каком формате, где лежат. Оценивайте, понятно ли вам. Если нет — пробуйте переписать, чтобы стало понятно.

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

Форма обратной связи, текст которой тоже заполняет технический писатель

Полезные ресурсы про тексты и интерфейс

А ещё — полезные книги:

  • А. Мильчин, Л. Чельцова «Справочник издателя и автора».

  • М. Ильяхов «Пиши, сокращай».

  • М. Ильяхов «Ясно, понятно: как доносить мысли и убеждать людей с помощью слов».

  • М. Ильяхов, Л. Сарычева «Новые правила деловой переписки».

  • Е. Рыжкова «Текст за текстом. Как создавать контент системно, быстро и легко».

  • Д. Роэм «Бла-бла-бла, или Что делать, когда слова не работают».

  • Л. ЛеФевер «Искусство объяснять».

  • А. Симмонс «Сторителлинг. Как использовать силу историй».

  • П. Черри «Продающие вопросы. Эффективный способ выяснить, чего действительно хотят ваши клиенты».

  • К. Егерев «Этой кнопке нужен текст».

Краткий пересказ от Yandex GPT