Представляем MadCap Flare 12!

25.03.2016

Компания ПроТекст, прямой поставщик продуктов компании MadCap Software для организации технического документирования по России и ближнему зарубежью, представляет новую версию флагманского продукта этой компании — MadCap Flare 12. Одновременно с выпуском новой версии MadCap Flare производитель обновил связанные с ним продукты — MadCap Contributor 8 для рецензирования проектов и MadCap Analyzer 9 для анализа проектов, чтобы учесть новые возможности документирования MadCap Flare 12 в своей линейке продуктов. Кроме того, в MadCap Contributor 8 появилась возможность бесплатного рецензирования проектов по техническому переводу, осуществляемых с использованием MadCap Lingo. Актуальные версии продуктов MadCap Software всегда есть в наличии в нашем интернет-магазине.

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

— Денис Кадилак, архитектор информации и менеджер команды, Blackbaud Читать дальше…

Адвокат пользователя: Наш технический контент клиентоориентирован? Да!

16.03.2016

Технический контент компании, производящей программные продукты и устройства, должен идеально сочетаться со всем контентом компании. Что это даёт и как этого добиться, рассказывает Нил Каплан в рубрике «Адвокат пользователя». Нил Каплан – менеджер по повышению квалификации в Condeco Software, Сан-Хосе (США), отвечает за изготовление, поставку и управление обучающим контентом и за документацию к продуктам Condeco.

Одно из преимуществ жизни в век информации — мы можем быстро и просто найти всё, что хотим купить. Кроме основных параметров цены, доступности и отзывов пользователей мы можем узнать об условиях клиентской поддержки производителя, а также получить документацию на продукт. Легко ли найти документацию? Легко ли она читается? Отвечает ли она на реальные вопросы или это двухстраничный краткий справочник, не обновлявшийся годами? Читать дальше…

Алгоритмы: Отделение контента от форматирования

10.03.2016

Статья входит в цикл «Понимание и применение структурированного писательства».

Марк Бейкер в своей серии статей переходит от описания общих принципов структурирования писательства к описанию алгоритмов. Очередная статья посвящена вопросам отделения контента от форматирования, что позволяет писателям сосредоточиться на контенте, меньше уделяя внимание форматированию, а в перспективе и поведению текста на различных устройствах.

На этой стадии этой серии статей я собираюсь начать рассматривать алгоритмы структурированного писательства. Алгоритм — это формализованный метод для выполнения задачи. Мы часто связываем алгоритмы с компьютерами, т.к. для того, чтобы заставить компьютер что-либо сделать, мы должны формализовать алгоритм и представить его в виде программы. Но люди так же могут исполнять алгоритмы. Это одна из причин, почему мы обращаемся к структурированному писательству, с тем, чтобы передать трудоёмкие и обременительные алгоритмы писательства и публикации машинам. Читать дальше…

Насколько глобален ваш английский: 8 способов писать просто и много экономить

03.03.2016

Статья Марсии Рифер Джонстон о том, как писать на английском, чтобы упростить жизнь сразу многим — неанглоязычным читателям, англоязычным читателям, переводчикам, людям с проблемами со зрением, экспертам по предмету — и заодно сэкономить солидную часть бюджета компаниям, которые переводят свой контент на другие языки. Кстати, в нашем блоге уже была статья этого же автора также на лингвистическую тему.

Какого *&^! это значит? Мы все хоть раз говорили так. Ладно, мы все хоть раз говорили что-то вроде этого. Фактически вы можете не знать, что означает *&^!. Это не однозначно. Даже если я сама не знаю, какое слово должно быть здесь, как же переводчик узнал бы, что с этим делать?

Зачем делать работу вашего переводчика сложнее – и дороже – чем она должна быть? Почему бы не исключить двусмысленности сразу же? Читать дальше…

Может ли программное обеспечение осуществлять техническое писательство?

26.02.2016

В этой заметке Роберт Деспрец (Robert Desprez) рассматривает возможность того, что современные технологии могут заместить потребность в технических писателях. В качестве объекта он изучает недавнюю книгу Мартина Форда (Martin Ford) «Восстание роботов / Rise of the Robots». Роберт Деспрец проработал техническим писателем в Ванкувере более 15 лет. Он регулярно публикует в своём блоге записи о писательстве для смартфонов, планшетов и ПК.

Много лет мы слышим, что работа технических писателей может быть превращена в товар и что эта работа выносится за пределы предприятия, а процессы, основанные на знаниях, переносятся в страны с меньшей заработной платой. Работа, где требуется хорошее образование, и которая хорошо оплачивается, например, работа юристов, бухгалтеров, радиологов и в области информационных технологий, включая технических писателей, перемещается в такие страны, как Индия. Читать дальше…

Вторая волна DITA

19.02.2016

Некоторое время назад в нашем блоге частенько появлялись статьи о стандарте DITA. Например, эта — ключевая статья о том, что такое DITA и зачем нам это нужно. Это была первая волна DITA (по крайней мере, в то время она докатилась до нас 🙂 ). А теперь говорят о новой, второй волне DITA. Давайте посмотрим, что она собой представляет.

У вас есть DITA. Что теперь?

Распространение DITA усиливается, и всё больше компаний задают этот вопрос. Для многих наших клиентов первая волна DITA означала решение вопроса о том, хорошо ли подходит этот стандарт для их контента. Компании, которые выбрали внедрение DITA, обнаружили, что повысилась общая эффективность производства контента благодаря усовершенствованному повторному использованию, автоматическому форматированию и так далее. Читать дальше…

На заметку руководителю: Развитие карьерной лестницы технического коммуникатора

12.02.2016

Алисса Фокс, директор по разработке информации и программному управлению компании NetIQ Corporation, обобщает свой опыт по управлению продвижением технических писателей в компании. Из статьи руководители предприятий узнают, по каким критериям организовать карьерные возможности для своих технических писателей, а технические писатели смогут свериться, не пора ли им просить повышение и что нужно делать, чтобы претендовать на более высокие карьерные уровни.

Мы продолжаем слышать об огромном количестве организаций, в которых нет чётко определённого карьерного пути для сотрудников, занятых в области технических коммуникаций. И даже среди тех, где есть «карьерная лестница», по которой персонал может подниматься, масштаб и критерии часто неясные, или, что ещё хуже, устаревшие. Читать дальше…

Качество в структурированном писательстве

03.02.2016

Статья входит в цикл «Понимание и применение структурированного писательства».

В очередном выпуске своей серии публикаций о структурированном писательстве Марк Бейкер изучает качество с точки зрения роботов, которые читают, а также реальную роль машины по отношению к писателю.

Когда я говорю программистам о том, чем занимаюсь, они часто спрашивают меня, чем же так важно структурированное писательство. У машин так хорошо получается читать человеческий язык, утверждают они, что семантическая разметка в качестве помощи машине стремительно становится бессмысленной. Но структурированное писательство — оно не в помощь машине. Оно для привлечения машины в помощь писателю. И больше всего писателю требуется помощь с качеством.

Роботы, которые читают

Машины действительно всё лучше и лучше понимают человеческий язык. Подход, который называется Глубинным обучением, всё больше становится основной технологией для таких компаний как Facebook, Google и Baidu как для понимания языка, так и для распознавания речи. Читать дальше…

Адвокат пользователя: Балансирование между документами оперативной поддержки и опытом пользователей

29.01.2016

Автор статьи – Нил Каплан (Neal Kaplan), главный менеджер по поддержке пользователей компании Interana в Редвуд-Сити, США. Нил имеет двадцатилетний опыт в области технических коммуникаций и обучении пользователей. Сравнивая документацию и здания, он делится своим опытом о том, как найти баланс между долговечностью и скоростью, между поверхностью и структурой, между оперативной поддержкой и опытом пользователей.

Я провёл День Благодарения у родственников в Сан-Диего. Мы посетили Парк Бальбоа, место нахождения двух международных экспозиций (1915 и 1935 гг.). Здания для этих экспозиций, хотя и тщательно детализированные, построены из мелкой проволочной сетки и штукатурки. Они должны простоять в течение года, пока выставлена эта экспозиция, и затем будут разрушены. Они красивы, но не предназначены стоять веками. Они оба были внесены в национальный реестр в качестве исторических памятников.

Всё это применимо и к большей части нашей документации (за исключением части про исторические памятники). Читать дальше…

Структурированное писательство: Внедрение домена управления

22.01.2016

Статья входит в цикл «Понимание и применение структурированного писательства».

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

До сих пор я говорил о трёх доменах, через которые проходит контент и в которых он может быть записан: домен носителя, домен документа и домен объекта. Но существует четвёртый домен, который внедряется в эту картину структурированного писательства: домен управления.

Почему я называю домен управления навязанным? Потому что домены объекта, документа и носителя — о записи контента как такового, а домен управления — не о контенте, а о процессе управления им. Читать дальше…