Александр Михайлов - Профессия Технический писатель, или Рыцари клавиатуры

В общих чертах, функционал техписаможно обозначить в виде трёх схем действий,две из которых противоположны друг другу. Но суть их всех можно сформулировать как «перевод с русского на русский»:

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

2. «От клиента — к разработчику».Технический писатель (здесь он выступает в роли аналитика) должен оценить потребности клиента, общаясь с ним, понять, что именно ему требуется, тщательно записать и систематизировать полученные сведения, а затем донести эти мысли до разработчиков в понятной им форме. Дополнительная задача: не допустить общения заказчика и разработчиков напрямую — разгребать результат общения «немого с глухим» бывает проблематично.

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

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

Теперь пройдёмся по списку задач, которые вам придётся выполнять.Наличие того или иного функционала будет незначительно различаться в зависимости от отрасли, в которой вы трудитесь, и отдела компании (поддержка, разработка, маркетинг и т. д.). Ключевая обязанность, которая будет точно — это документирование продукта, который производит ваша компания. Сюда может включаться самая разная документация, но руководящие тексты для пользователей различных категорий там будут однозначно. В остальном же возможны два варианта:

1. Полное документирование программного продукта или оборудования.Если вы работаете в небольшой компании, то вам достаётся, как правило, целиком и полностью две задачи: составление пользовательской документации и составление руководства администратора / сервисного инженера. Этих двух документов (иногда ещё требуется набор бумаг по ГОСТ для сдачи продукта в эксплуатацию по государственному заказу) хватает для «бумажного» сопровождения большинства изделий и программ. Иногда требуется написать только одно из этих руководств, поскольку одни программы не имеют пользователей, а другие — администраторов. Например:

• IM-клиент — стационарное приложение для одного рабочего места, оно не имеет администратора, есть только конечный пользователь, которому и нужна инструкция;

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

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

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

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

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

1. Создание технических статей и обзоров для СМИ(техническое описание производимого компанией продукта, его сильных сторон и недостатков), материалов рекламного характера, где первичная цель — «расхвалить» продукт, попутно показав его техническую начинку.

2. Написание аналитических статей.Эти материалы также пишутся для СМИ с целью продвижения продукта, но в них говорится не только о продукте вашей компании, но и о похожих разработках конкурентов. В такой статье вам потребуется объективно и беспристрастно по ряду параметров сравнить ваше изделие или программу с другими аналогичными продуктами. Известны случаи, когда такие статьи не доходили до публикации из-за неприятного вывода: у соседа-то лучше!

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

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