Публикации
Эджайл и технические коммуникации: как видят скрам писатели (часть 1)
18.11.2013
В данной статье Алисса Фокс, директор по производству информации и программному менеджменту из Техаса, рассказывает о том, как воспринимать и участвовать техническим писателям в производственных процессах, организованных по технологии скрам (scrum), входящей в идеологию эджайл (agile).
Среди всех форм разработки по эджайл, которые могут выбрать и использовать команды, скрам является наиболее распространённой. Скрам – это подход к разработке по эджайл, который делает акцент на близком взаимодействии посредством летучек с целью увеличения скорости и гибкости процесса разработки.
Скрам-команда состоит из владельца продукта (часто он является менеджером по продукту), разработки, инженеров по качеству и разработки информации (это вы!). Важно, чтобы писатели работали в скрам-команде бок о бок с разработчиками и инженерами по качеству, чтобы оставаться в курсе всех аспектов: дизайн, актуализация проекта, разработка продукта и т.д.
Тенденции технических коммуникаций: ломаем барьеры
10.07.2013Вторая публикация из серии статей о тенденциях в области технической коммуникации.
Помните о традиционной роли технического писателя: работать весь день в одиночестве, запершись в монашеской келье? И я помню. Даже если когда-то этот стереотип был правдой, сегодня он категорически устарел. Сегодня одной из составных частей мира технических писателей является сотрудничество.
Сотрудничество означает, что многие люди делятся контентом, и, зачастую, совместно работают над одним и тем же материалом. Раньше контент можно было получить всего из нескольких источников, а очень часто источник был и вовсе один – отдел технических публикаций.
Сотрудничество может быть простым, как по сценарию, описанному Хулио Васкесом в статье «Зона сотрудничества», или сложным, как описано в превосходной книге Энн Джентл «Обсуждения и сообщество».
При написании технической документации сотрудничество в основном происходит внутри компании. Например, отдел технических публикаций может работать с отделом маркетинга или технической поддержкой. Мы обнаружили, что сотрудничество возникает не на пустом месте. В большинстве случаев внутри компании необходимо создавать партнерские отношения. Менеджеры любят называть это «крушением барьеров»: создание рабочего сотрудничества, где барьеров не существует.
Основы: роль технического редактора
17.06.2013
Вы – писатель, работающий с техническим редактором? Если да, считайте, что вы счастливчик; многие технические писатели не имеют такой роскоши, как услуги редактора. Писатели, работающие в проектной группе, часто редактируют документы друг друга, тогда как у их коллег, работающих в одиночку, может не быть другого выбора, кроме как выверять свою работу самостоятельно. Хотя эти сценарии широко распространены, они не являются примером для подражания.
Писать и редактировать – это разные процессы; каждый требует свой набор навыков и имеет свой принцип. Некоторые управленцы не до конца понимают разницу между написанием текста и его редактированием, не осознают, какую пользу может принести редактор как отдельный сотрудник. По мнению Каролин Руд (Carolyn Rude) и Энджелы Итон (Angela Eaton), соавторов «Технического редактирования», технический редактор – это эксперт по коммуникациям, языку и нуждам аудитории. Хороший редактор способен оценить картину в целом так же хорошо, как и мелкие детали, и может играть ключевую роль в проектах по документированию.