Технические авторы: Необходимое Зло

Плохо знакомый с письмом технологии, или думающий о старте? Ключ к успеху признает, что технические авторы - необходимое зло.

Технические авторы необходимы, потому что кто-то должен написать пользователю doco. Программисты и менеджеры, уверенные как ад, не хотят к. Это - фактически часть причины, что Вы являетесь злыми, также. В моем опыте большинство программистов и менеджеров думают, что они могли написать руководства, если бы они хотели к? они только не хотят к. Они не могли бы написать весь flowery как технические авторы, но то, что они пишут, правильно.

К сожалению, это - весьма часто все, что это важно для программистов и менеджеров.

Есть чувство в пределах окружающей среды программного обеспечения та точность = качество. Анализ аудитории, doco удобочитаемость, последовательность, удобство и простота использования, действительный и страдательный залог, запятые в списке трех или больше пунктов? Все эти вещи относительно незначительны ко всем, но техническому автору. О? и пользователь.

В мире, где точность все важна, много пробегается через голову куклы. Я не знаю, является ли это интеллектуальный снобизм, но программисты и менеджеры, кажется, думают, что, если они понимают это, пользователь - также. Не имеет значения, делают ли они? они ДОЛЖЕН! Глупые пользователи! Возможно это - окончательная месть выродка?

Ваш документ может быть на 100 % точным, но если аудитория не может прочитать его, Вы потратили впустую свое время.

Итак, почему любой не признает это? Они делают! Это - фантастическая часть. В теории все соглашаются с Вами, это только практически, что Вы узнаете себя в холоде. Я не знаю, почему это случается. Возможно это - потому что большинство этих парней никогда не делало письма технологии.

Таким образом технические авторы тратят слишком долго волнение по поводу незначительных вещей. И они беспокоят программистов и менеджеров с незначительными вещами. Но они - необходимые вещи. Иначе, почему был бы Вы использоваться. Возможно отсутствие простых логических коротких замыканий их мозги. Кто знает?

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

Но есть верх. Я не хочу Вас думающий, что это все плохо.

У быть у основания кучи есть ее преимущества. Вы можете пойти незамеченные в течение многих лет, если Вы хотите. Если Вы не видели кино, Место Office, Вы должны нанять это. Есть маленький хорьковый тип в эти, который был позвольте go несколько лет назад. Проблема, никто когда-либо не говорил ему, и из-за затруднения в платежной ведомости ему все еще заплатили. Никто когда-либо не замечал.

Быть техническим автором немного как этот.

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

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

Одна вещь, о которой Вы должны знать, хотя, то, что Ваш средний технический автор в программном обеспечении тратит только приблизительно 50 % его или её времени, сочиняя. Остальная часть Вашего времени потрачена, планируя, решение проблемы, устанавливая Ваш компьютер, исследование, беря интервью у программистов, сочиняя работу pracs?

Я всегда находил, что это был хороший баланс, все же.

Именно, когда я начал руководящие команды, основание действительно выпало. Тогда процент спадал приблизительно до 10-20 %. Были времена, когда я пойду месяцы, не сочиняя помощи вообще. Это может быть очень расстраивающим, особенно если Вам особенно не нравится справляться.

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

У меня действительно нет никакого совета для Вас здесь. Если это будет собираться случаться, то это случится. Только знайте это, и знают, что, если Вы падаете в роль управления, это собирается быть трудным. (Это не должно сказать, что это не может быть полезно хотя?)

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

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

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

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




  • Меню