Всё для технического документирования
+7 (495) 001-40-42
Разработка технической документации
Курсы для технических писателей
Программное обеспечение

Публикации

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

25.03.2016

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


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

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



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

16.03.2016

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


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



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

10.03.2016

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

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


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



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

03.03.2016

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


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

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



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

26.02.2016

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


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



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

19.02.2016

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


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

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



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

12.02.2016

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


 

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



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

03.02.2016

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

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


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

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

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



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

29.01.2016

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


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

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



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

22.01.2016

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

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


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

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