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