Технический писатель это кто и чем занимается

18.09.2024 

 

 

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

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

Кто такие технические писатели в IT

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

С кем взаимодействует технический писатель

Разработкой программных продуктов занимается сразу несколько специалистов. Именно поэтому в своей работе технический писатель может взаимодействовать с разными участниками IT-проектов:

• Разработчики. Технический писатель интерпретирует «труды» программистов в понятной и доступной для рядовых пользователей форме. Он напрямую контактирует с разработчиками и узнает от них об особенностях функционирования системы.

• Финансисты. Для того чтобы оплатить услуги подрядчика или компании требуется определенный перечень документов. Их созданием и заполнением занимаются технические писатели.

• Аналитики. В процессе общения с аналитическими специалистами технические писатели узнают логику создания IT-продукта, которая была придумана для разработчиков.

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

• Руководство проекта. Основная задача технического писателя в данном случае – проконтролировать соблюдение полного перечня формальностей всеми участниками IT-проекта.

Цели работы технического писателя

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

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

 

Куда расти техническому писателю

Предположим, что человек занял позицию начинающего технического писателя и спустя некоторое время перерос Junior-уровень. Вполне логично, что он задумается, а куда ему двигаться дальше? Есть ли какие-то будущие перспективы, или же ему придется все время заниматься заполнением документов?

Ответ однозначен – нет. Технические писатели могут развиваться как в горизонтальном, так и в вертикальном направлении. Рассмотрим немного подробнее горизонтальный рост.

 

Первая зона роста – управление

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

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

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

• Учитывая общий объем исходной информации спланировать потенциальные трудовые затраты, необходимые для создания технических документов.

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

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

Вторая зона роста – аналитическая деятельность

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

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

Уникальные случаи аналитики, как правило, возникают, когда необходимо предоставить заказчику подробную информацию о стоимости работ, связанных с формальными процессами по подготовке проекта к конкурсу. В данном случае специалист должен разобраться со всеми аспектами реализации – поговорить с разработчиками и подробнее узнать о функционале IT-продукта. Если разработчики еще не выполнили свою работу, то обратиться к product-менеджерам, которые специализируются на развитии рассматриваемого продукта. Конечный результат работы – оформленный отчет, подготовленный для предоставления заказчику.

Третья зона роста – решение юридических вопросов

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

Главным «подводным камнем» в договоре является требование к исполнителю об уведомлении своего заказчика за несколько дней о готовности проведения испытания проекта. В противном случае он может столкнуться с серьезными проблемами. Если специалист умеет быстро анализировать договоры, то он сможет определить потенциальные места, в которых могут возникнуть проблемы. Это очень важная особенность, так как руководству бывает сложно разбираться с юридическими аспектами IT-проектов. И в таком случае перед техническим писателем стоит важная задача – обеспечить «формальное прикрытие» своего начальства.

Вертикальный рост техписа

В случае с вертикальным развитием технического писателя все гораздо проще. Все специалисты разделены по нескольким уровням – начальный (Junior), средний (Middle) и продвинутый (Senior).

1. Новички (джуниоры) обладают базовыми знаниями и аналитическими навыками. И в решении более сложных вопросов им может потребоваться помощь более опытных писателей.

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

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

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

Кому подходит карьера технического писателя

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

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

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

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

Первый тип – специализация на технической документации

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

Второй тип – решение и согласование вопросов

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

Третий тип – защита собственного мнения

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

Итак, подведем основные итоги:

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

• Технический писатель может расти и в горизонтальном, и в вертикальном направлении.

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

Hard-skills также напрямую зависят от программного продукта. К тому же, подобные навыки можно улучшить со временем прямо на рабочем месте, чего не скажешь о soft-skills.