Технический писатель — это профессиональный коммуникатор, чья задача — донести сложную информацию простыми словами до широкой общественности или очень избранной группы читателей. Технические писатели исследуют и создают информацию с помощью различных средств доставки (электронных, печатных, аудиовизуальных и даже сенсорных). [1] Примерами типов информации являются онлайн-справка , руководства, технические документы , спецификации дизайна , планы проектов и планы тестирования программного обеспечения. С ростом электронного обучения технические писатели все чаще нанимаются для разработки онлайн-материалов для обучения.
По данным Общества технической коммуникации (STC): [2]
Техническое письмо иногда определяется как упрощение сложного. В таком кратком и обманчиво простом определении заложен целый ряд навыков и характеристик, которые на определенном уровне затрагивают практически все области человеческой деятельности. Значительное подмножество более широкой области технической коммуникации, техническое письмо подразумевает передачу сложной информации тем, кому она нужна для выполнения какой-либо задачи или достижения цели.
Другими словами, технические писатели берут передовые технические концепции и доносят их до целевой аудитории максимально ясно, точно и полно, гарантируя, что работа будет доступна пользователям.
Курт Воннегут описывал технических писателей как: [3]
...обученные не раскрывать почти ничего о себе в своих произведениях. Это делает их уродами в мире писателей, поскольку почти все остальные заляпанные чернилами негодяи в этом мире раскрывают читателю о себе очень многое.
Инженеры, ученые и другие специалисты также могут заниматься техническим письмом ( редактированием , корректурой и т. д.), но чаще нанимают профессиональных технических писателей для разработки, редактирования и форматирования материалов и следуют установленным процедурам рецензирования в качестве средства донесения информации до своей аудитории.
Согласно данным Общества технической коммуникации (STC), профессии технической коммуникации и технического письма впервые были упомянуты во время Первой мировой войны , [2] когда технические документы стали необходимостью для военных целей. Название должности появилось в США во время Второй мировой войны, [4] хотя только в 1951 году было опубликовано первое объявление «Требуется технический писатель». [5] Фактически, должность «Технический писатель» была добавлена в Справочник по профессиональной занятости Бюро статистики труда США только в 2010 году. [6] В 1940-х и 50-х годах технические коммуникаторы и писатели нанимались для создания документации для военных, часто включающей подробные инструкции по новому оружию. Другие технические коммуникаторы и писатели были вовлечены в разработку документации для новых технологий, которые были разработаны примерно в это время. По словам О'Хары: [7]
Война была важнейшим двигателем научно-технического прогресса. Медицинский корпус армии США боролся с малярией в джунглях Панамы, Химический корпус продвигал химические достижения во взрывчатых веществах и ядовитых газах (и защите от них), Манхэттенский округ Инженерного корпуса буквально совершил квантовый скачок в понимании физики, а Воздушный корпус стал пионером в проектировании авиации.
С первых дней существования профессии технические писатели работали в командах с пулом других технических писателей. По сей день большинство организаций по-прежнему нанимают команду для создания и редактирования технических текстов для назначенного продукта или услуги. Как член команды технические писатели работают независимо, исследуя свои задания. Регулярные индивидуальные встречи с экспертами по предметной области (SME) и внутренние исследовательские ссылки (например, чертежи, спецификации, спецификации, листы данных и т. д.) предоставляют техническому писателю необходимые проверки для обеспечения точности документа. После того, как точность документа была рассмотрена и одобрена назначенным SME, технические писатели полагаются на свою команду писателей для предоставления экспертных оценок. Экспертная оценка фокусируется исключительно на формате контента, стиле и стандартизации грамматики. Цель экспертных оценок команды — гарантировать, что техническая документация организации «говорит одним голосом».
Во время Второй мировой войны одной из важнейших характеристик технических писателей была их способность следовать строгим правительственным спецификациям для документов. [7] После войны развитие новых технологий, таких как компьютеры, позволило техническим писателям работать в других областях, создавая [7] «руководства пользователя, краткие справочные руководства, руководства по установке оборудования и шпаргалки». После войны (1953–1961) технические коммуникаторы (включая технических писателей) заинтересовались «профессионализацией» своей области. [6] По словам Мэлоуна, [6] технические коммуникаторы/писатели делали это, создавая профессиональные организации, развивая «специализированный корпус знаний» для профессии, навязывая этические стандарты техническим коммуникаторам, инициируя разговор о сертификации практиков в этой области и работая над аккредитацией образовательных программ в этой области.
Профессия продолжает расти — по словам О'Хары, в профессии писателя/редактора, включая технических писателей, количество должностей увеличилось на 22% в период с 1994 по 2005 год. [7] Современные технические писатели работают в самых разных контекстах. Многие технические писатели работают удаленно, используя VPN , или общаются со своей командой через платформы видеотелефонии , такие как Skype или Zoom . Другие технические писатели работают в офисе, но делятся контентом со своей командой через сложные системы управления контентом , которые хранят документы в Интернете. Технические писатели могут работать над правительственными отчетами, внутренней документацией, инструкциями для технического оборудования, встроенной справкой в программное обеспечение или системы или другими техническими документами. По мере развития технологий спектр возможностей для технических писателей будет продолжать расширяться. Многие технические писатели отвечают за создание технической документации для мобильных приложений или справочной документации, созданной в мобильных или веб-приложениях. Они могут отвечать за создание контента, который будет просматриваться только на портативном устройстве; большая часть их работы никогда не будет опубликована в печатной брошюре, как техническая документация прошлого.
Исторически сложилось так, что технические писатели или технические и профессиональные коммуникаторы занимались написанием и коммуникацией. Однако в последнее время дизайн пользовательского опыта (UX) стал более заметным в технических и профессиональных коммуникациях, поскольку компании стремятся разрабатывать контент для широкого круга аудиторий и впечатлений. [8]
Ассоциация профессионалов в области пользовательского опыта определяет UX как «каждый аспект взаимодействия пользователя с продуктом, услугой или компанией, который составляет восприятие пользователем целого». [9] Таким образом, «проектирование пользовательского опыта как дисциплина касается всех элементов, которые вместе составляют этот интерфейс, включая макет, визуальный дизайн, текст, бренд, звук и взаимодействие». [9]
Теперь ожидается, что технические навыки общения должны сочетаться с UX-дизайном. Как утверждают Верхалсдонк, Ховард и Там: «...недостаточно писать хороший контент. Согласно ожиданиям отрасли, наряду с написанием хорошего контента теперь также важно разрабатывать хороший опыт вокруг этого контента». [8] Технические коммуникаторы теперь должны учитывать различные платформы, такие как социальные сети и приложения, а также различные каналы, такие как веб и мобильные устройства. [8]
Как объясняет Редиш, специалист по техническим коммуникациям больше не пишет контент, а «пишет вокруг самого интерфейса», поскольку разрабатывается пользовательский опыт, окружающий контент. Это включает в себя полезный контент, настроенный под конкретные потребности пользователя, который адресует эмоции, чувства и мысли пользователя по разным каналам в UX-экологии. [10] [8]
Лауэр и Брумбергер далее утверждают: «…UX является естественным продолжением работы, которую уже выполняют технические коммуникаторы, особенно в современном технологическом контексте адаптивного дизайна, в котором контент развертывается в широком спектре интерфейсов и сред». [11]
UX-дизайн — это продукт как технической коммуникации, так и идентичности пользователя. Эффективный UX-дизайн настраивается на максимизацию удобства использования в соответствии с уникальными пользовательскими данными в процессе, называемом этнографией дизайна. [12] Этнография дизайна тщательно анализирует культуру пользователя с помощью интервью и тестов удобства использования, в которых технический писатель напрямую погружается в пользовательскую среду и собирает информацию об UX от местных пользователей.
Помимо солидных исследовательских, языковых, письменных и редактированных навыков, технический писатель может обладать навыками:
Технический писатель может применять свои навыки в производстве нетехнического контента, например, писать информацию для потребителей высокого уровня . Обычно технический писатель не является экспертом по предметной области (SME), но опрашивает SME и проводит исследования, необходимые для написания и компиляции технически точного контента. Технические писатели выполняют как первичные, так и вторичные исследования, чтобы полностью понять тему. [ необходима цитата ]
Опытные технические писатели обладают способностью создавать, усваивать и передавать технический материал в сжатой и эффективной манере. Они могут специализироваться в определенной области, но должны хорошо понимать продукты, которые они описывают. [14] Например, писатели API в основном работают с документами API , в то время как другие технические писатели специализируются на электронной коммерции , производстве, научных или медицинских материалах. [14]
Технические писатели собирают информацию из многих источников. Их источники информации обычно разбросаны по всей организации, которая может варьироваться от разработчиков до отделов маркетинга.
По словам Маркеля, [15] полезные технические документы оцениваются по восьми характеристикам: «честность, ясность, точность, полнота, доступность, краткость, профессиональный вид и корректность». Технические писатели сосредоточены на использовании своих тщательных исследований для создания эффективных документов, которые соответствуют этим восьми характеристикам.
Чтобы создать эффективную техническую документацию, писатель должен проанализировать три элемента, которые составляют риторическую ситуацию конкретного проекта: аудиторию, цель и контекст. [16] За ними следует дизайн документа, который определяет, что видит читатель.
Технические писатели стремятся упростить сложные концепции или процессы, чтобы максимизировать понимание читателя. Конечная цель конкретного документа — помочь читателям найти то, что им нужно, понять то, что они находят, и использовать то, что они понимают, надлежащим образом. [17] Чтобы достичь этой цели, технические писатели должны понимать, как их аудитория использует и читает документацию. Анализ аудитории в начале проекта документа помогает определить, что требуется аудитории для конкретного документа.
При анализе аудитории технический писатель обычно спрашивает: [17]
Точный анализ аудитории дает набор рекомендаций, которые определяют содержание документа, его дизайн и презентацию (система онлайн-справки, интерактивный веб-сайт, руководство и т. д.), а также тон и уровень знаний.
Технический писатель анализирует цель (или функцию) коммуникации, чтобы понять, чего должен достичь документ. Определение того, направлена ли коммуникация на то, чтобы убедить читателей «думать или действовать определенным образом, дать им возможность выполнить задачу, помочь им понять что-то, изменить свое отношение» [16] и т. д., помогает техническому писателю определить, как форматировать свою коммуникацию и какой тип коммуникации он выберет (система онлайн-справки, официальный документ, предложение и т. д.).
Контекст — это физические и временные обстоятельства, в которых читатели используют коммуникацию, например: за рабочим столом в офисе, на производственном предприятии, в течение медленных летних месяцев или в разгар кризиса в компании. [16] Понимание контекста ситуации подсказывает техническому писателю, как читатели используют коммуникацию. Это знание существенно влияет на то, как писатель форматирует коммуникацию. Например, если документ представляет собой краткое руководство по устранению неполадок в элементах управления на небольшом водном судне, писатель может заламинировать страницы, чтобы увеличить срок их службы.
После того, как вышеуказанная информация собрана, документ разрабатывается для оптимальной читаемости и удобства использования. По словам одного эксперта, технические писатели используют шесть стратегий дизайна для планирования и создания технической коммуникации: расположение, акцент, ясность, краткость, тон и этос. [16]
Технические писатели обычно обладают смесью технических и писательских способностей. Обычно они имеют степень или сертификат в технической области, но могут иметь и в журналистике, бизнесе или других областях. Многие технические писатели переходят из другой области, например, журналистики, или технической области, например, инженерии или науки, часто после получения важных дополнительных навыков на курсах технических коммуникаций. [18]
Чтобы создать технический документ, технический писатель должен понимать предмет, цель и аудиторию. Они собирают информацию, изучая существующий материал, опрашивая представителей малого и среднего бизнеса и часто фактически используя продукт. Они изучают аудиторию, чтобы узнать ее потребности и уровень технического понимания.
Жизненный цикл разработки технической публикации обычно состоит из пяти этапов, согласованных с общим планом разработки продукта: [19]
Жизненный цикл разработки документа обычно состоит из шести фаз (это зависит от организации, в которой они развиваются).
Это похоже на жизненный цикл разработки программного обеспечения.
Хорошо написанные технические документы обычно следуют формальным стандартам или руководствам. Техническая документация поставляется во многих стилях и форматах в зависимости от среды и предметной области. Печатная и онлайн-документация могут отличаться по-разному, но по-прежнему придерживаются в основном идентичных руководств по прозе, структуре информации и макету. Обычно технические писатели следуют соглашениям по форматированию, описанным в стандартном руководстве по стилю . В США технические писатели обычно используют The Associated Press Stylebook или Chicago Manual of Style (CMOS). Во многих компаниях есть внутренние корпоративные руководства по стилю, которые охватывают конкретные корпоративные вопросы, такие как использование логотипа, брендинг и другие аспекты корпоративного стиля. Microsoft Manual of Style for Technical Publications является типичным примером.
Инженерные проекты, особенно оборонные или аэрокосмические, часто следуют национальным и международным стандартам документации, таким как ATA100 для гражданских самолетов или S1000D для гражданских и оборонных платформ.
Технические писатели часто работают в составе группы по написанию или разработке проекта. Обычно писатель заканчивает черновик и передает его одному или нескольким SME, которые проводят технический обзор для проверки точности и полноты. Другой писатель или редактор может выполнить редакционный обзор , который проверяет соответствие стилям, грамматике и читабельности. Этот человек может запросить разъяснения или внести предложения. В некоторых случаях писатель или другие лица проверяют документ на членах аудитории, чтобы внести улучшения в удобство использования . Окончательный продукт обычно следует контрольному списку проверки, чтобы гарантировать качество и единообразие опубликованного продукта. [20]
Физическая рабочая среда большинства технических писателей, работающих в компании, обычно представляет собой открытый офис с настольными компьютерами и индивидуальными столами. Рабочее пространство технического писателя во многом зависит от его отрасли. Перепись Intercom 2018 года, проведенная в основном среди американских технических коммуникаторов, показала, что большинство респондентов работали в сфере технологий и ИТ. [21] Распространенность различных отраслей в технической документации коррелирует с географическим положением и отраслями, которые наиболее распространены в определенных регионах мира. Исследование карьеры в области технических коммуникаций в Европе показало, что большинство технических коммуникаторов работают в сфере ИТ.
Вслед за рекомендациями Всемирной организации здравоохранения оставаться дома в марте 2020 года из-за пандемии COVID-19 сотрудники по всему миру столкнулись с переходом от очной работы к удаленной и/или виртуальной. По состоянию на 2023 год, после смягчения политики социального дистанцирования, многие организации решили сохранить возможность для сотрудников работать удаленно. В конкретном случае профессиональных технических писателей это изменение вынуждает использовать альтернативный подход к общению с экспертами по предметной области, коллегами и руководителями проектов, которые непосредственно вовлечены в процесс технической коммуникации. Сотрудники, работающие удаленно, обычно полагаются на виртуальную, иногда асинхронную, коммуникацию с коллегами и проводят рабочее время либо дома, либо в изолированном офисе. [22]
Не существует единого стандартного пути карьеры для технических писателей, но они могут перейти в управление проектами, а не в других писателей. Писатель может продвинуться до должности старшего технического писателя, управляя сложными проектами или небольшой командой писателей и редакторов. В более крупных группах менеджер по документации может управлять несколькими проектами и командами.
Технические писатели также могут получить экспертные знания в определенной технической области и перейти в смежные области, такие как анализ качества программного обеспечения или бизнес-анализ. Технический писатель, который становится экспертом по предметной области в определенной области, может перейти от технического письма к работе в этой области. Технические писатели обычно создают обучение для технологий, которые они документируют, включая руководства для занятий в классе и электронное обучение, а некоторые переходят на специализацию в качестве профессиональных тренеров и разработчиков учебных материалов.
Технические писатели, обладающие навыками письма, могут присоединиться к компаниям печатных или электронных СМИ, что потенциально дает им возможность заработать больше денег или улучшить условия труда.
В апреле 2021 года Министерство труда США ожидало, что занятость технических писателей вырастет на семь процентов с 2019 по 2029 год, что немного быстрее, чем в среднем по всем профессиям. Они ожидают, что возможности трудоустройства, особенно для кандидатов с техническими навыками, будут хорошими. BLS также отметило, что расширение «научных и технических продуктов» и потребность в технических писателях для работы в «веб-поддержке продуктов» будут способствовать росту спроса. [23]
По данным ZipRecruiter , по состоянию на май 2022 года средняя годовая заработная плата внештатного технического писателя в США составляет 70 191 доллар США . [24]
Технические писатели могут иметь различные должности, включая технического коммуникатора, разработчика информации , разработчика технического контента или специалиста по технической документации . В Соединенном Королевстве и некоторых других странах технического писателя часто называют техническим автором или автором знаний .
{{cite book}}
: CS1 maint: несколько имен: список авторов ( ссылка )