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

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

4. При описании API / программного кода / структуры БД / элементной базы устройства вам гарантированно не потребуется знать ничего за пределами вашего продукта, но в нём вы должны разбираться не хуже разработчика — знать все фрагменты кода, названия таблиц БД и так далее. Соответственно, вам потребуются навыки программиста или электронщика — без них «миссия невыполнима». Эта документация относится к разряду наиболее сложной среди всех возможных задач технического писателя.

В работе технического писателя большая часть рабочего времени уходит на получение, анализ и систематизацию данных, необходимых для написания документации, а сам процесс набора текста на клавиатуре занимает от силы 5-7 % времени. Поэтому при оценке времени, необходимого на выполнение поставленной задачи, лучше всего ориентироваться на следующие моменты:

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

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

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

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

• Сколько времени потребуется на правку.После завершения работы с документом его надо внимательно вычитать. Причём несколько раз и, в идеале, не только своими силами (подробнее об этом в разделе «Завершающий этап работы с текстом»). Также нужно оценить время, которое потребуется заказчику на просмотр текста и подготовку замечаний (это должно быть объективное время, без задержек с его стороны — вы примерно должны представлять, сколько времени потребуется на проверку вашего текста). И, соответственно, время на финальную правку.

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

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

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

Итак, во-первых, нужно определить, платят ли вам за конечный объём текста, за сам факт его подготовки (при фиксированной оговоренной сумме) или за количество потраченных часов.

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