Профессия "Технический писатель", или "Рыцари клавиатуры" - [46]
Существует три основных единых стандарта: программной (ГОСТ 19), конструкторской (ГОСТ 2), технологической (ГОСТ 3) и руководящей (РД) документации. Также применяется ГОСТ 34 — на автоматизированные системы. Ознакомиться с ними подробнее можно в сети Интернет по соответствующим запросам, ибо на каждую область есть свой ГОСТ и на описание управления каждым оборудованием — своя РД. По сути, ГОСТ для техписа — это как таблицы Брадиса для математика — нужно знать как им пользоваться, но заучивать что-то наизусть смысла не имеет — всё необходимое чётко прописано в самом стандарте.
Эти международные стандарты применяются во всём мире, кроме, соответственно, стран, применяющих ГОСТ. Практически вся документация ко всей электронной технике и ПО, разрабатываемая повсюду в мире, исключая руководства для домашних пользователей, выполняется в соответствии с ними. Знание этих стандартов в настоящее время требуется лишь в том случае, если вы работаете в зарубежной компании или планируете переезд за рубеж.
IEEE 1063 — это стандарт, разработанный Институтом инженеров по электротехнике и электронике (IEEE) и содержащий все регламенты по документированию разработок в этих областях. К большому сожалению, разработок в этой отрасли в РФ очень мало (они есть, но их доля на рынке исчезающее мала), поэтому знание этих стандартов будут практически бесполезны для работы внутри РФ, но весьма ценны при написании документации для зарубежных компаний на основе, например, аутсорсинга.
ISO (ISO/IEC FDIS 18019:2004 и ISO/IEC 26514:2008) — собственно, это стандарт-руководство по написанию руководств. В отличие от IEEE, ISO может использоваться где угодно и поэтому порой встречается даже в РФ. Это связано с тем, что существуют компании, которые работают в том числе и для иностранных клиентов и, соответственно, вынуждены готовить русско- и англоязычные документы по международным стандартам.
Аналогично ГОСТу, нужно уметь читать эти стандарты и знать где их найти — хранить их в голове как таблицу умножения вовсе необязательно. Это справочная информация, которая всегда доступна и которую нужно уметь применять на практике.
Небольшую статью про эти стандарты можно прочитать здесь: http://habrahabr.ru/post/l16825/.
2. Документирование API
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.
