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

IEEE 1063 —это стандарт, разработанный Институтом инженеров по электротехнике и электронике (IEEE) и содержащий все регламенты по документированию разработок в этих областях. К большому сожалению, разработок в этой отрасли в РФ очень мало (они есть, но их доля на рынке исчезающее мала), поэтому знание этих стандартов будут практически бесполезны для работы внутри РФ, но весьма ценны при написании документации для зарубежных компаний на основе, например, аутсорсинга.

ISO (ISO/IEC FDIS 18019:2004 и ISO/IEC 26514:2008)— собственно, это стандарт-руководство по написанию руководств. В отличие от IEEE, ISO может использоваться где угодно и поэтому порой встречается даже в РФ. Это связано с тем, что существуют компании, которые работают в том числе и для иностранных клиентов и, соответственно, вынуждены готовить русско- и англоязычные документы по международным стандартам.

Аналогично ГОСТу, нужно уметь читать эти стандарты и знать где их найти — хранить их в голове как таблицу умножения вовсе необязательно. Это справочная информация, которая всегда доступна и которую нужно уметь применять на практике.

Небольшую статью про эти стандарты можно прочитать здесь: http://habrahabr.ru/post/l16825/.

API — интерфейс программирования приложений. В современном мире приложения и устройства общаются между собой на особых языках, которые и называются API того или иного устройства, веб-сервиса или приложения.

Технический писатель, описывающий API (их часто называют API technical writer), должен глубоко разбираться в продукте, который описывает, почти на уровне разработчика.

API technical writer пишет для других разработчиков, поэтому должен также владеть инструментами разработки.

Собственно, описания API-интерфейсов достаточно однообразны и формализованы, поэтому для написания подобных документов достаточно обладать компетенцией технического писателя начального уровня, но при этом необходимо глубоко погружаться в изучение описываемых продуктов и плотно общаться с разработчиками как продукта, API которого описывается, так и работать с обратной связью от разработчиков, использующих эти API (потребители данной документации).

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

Полезная статья о том, что такое API, для чего используется, зачем и как начать его документировать, какие инструменты использовать, как взаимодействовать с коллегами, какие существуют основные принципы: https://protext.su/pro/itak-vam-nuzhno-dokumentirovat-api/

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

https://protext.su — сайт компании «ПроТекст». Блог о техническом документировании с полезными материалами, записи онлайн-конференций и вебинаров, курсы для технических писателей.

https://t.me/technicalwriters — Telegram-канал «Технические писатели», будет полезен для общения с коллегами и поиска работы.

https://yandex.ru/blog/x-plain — клуб технических писателей от команды Яндекс.

http://techwhirl.com/ (англ.) — портал, посвящённый управлению контентом и техническим коммуникациям. Содержит множество полезных статей и новостей на разные темы.

http://idratherbewriting.com/ (англ.) — блог технического писателя из США Тома Джонсона. Статьи в основном о документации для разработчиков. Основные темы: документирование API, визуальные коммуникации, видеодокументация, информационная архитектура, контент-стратегия.

http://thecontentwrangler.com/ (англ.) — портал с большим количеством материалов на тему контента, охватывает множество разных аспектов (управление, стратегия, коммуникации, локализация и другие).

https://ru.libreoffice.org/ — бесплатный аналог MS Office.

http://www.omegat.org/ru/omegat.html — бесплатный инструмент для автоматизации переводов.

На этом наша экскурсия по профессии «Технический писатель» заканчивается. Все необходимые сведения в нашей книге мы изложили, теперь — дело за вами!

Александр Владимирович МИХАЙЛОВ

Родился в Новосибирске в 1987 г. В 2010 г. окончил Новосибирский государственный технический университет. С 2006 г. пишет статьи для различных изданий, по большей части — IT-обзоры и аналитические материалы. С 2007 по 2011 гг. опубликовал также несколько технических книг, посвященных интернет-технологиям и информационной безопасности. С 2011 г. — сооснователь и директор аутсорсинговой компании ООО «ПроТекст», специализирующейся на разработке технической документации и обучении технических писателей (в рамках курсов «Разработка технических текстов и документации», «Техническая документация в Atlassian Confluence» и других). Преподавал курс «Основы технического документирования» в НГТУ (Новосибирск) и БГУ (Минск).

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