Опыт использования единого источника на основе Adobe FrameMaker

Светлана Нудельруководитель отдела разработки технической документации

Positive Technologies

Зачем нам нужен единый источник

Что было?

― Множество разрозненных документов об одном и том же

― Учебный курс по продуктам компании

― Неразбериха в стилях, форматах, шаблонах

― Много людей — «кто во что горазд»

― Разные форматы документов

― Нужен доступ для разных категорий сотрудников

Что было?

― Как выпустить документ в другом формате

― Как дать доступ к самой последней версии всем, кто заинтересован

― Трудно сопровождать

И вот мы внедрили Adobe FrameMaker

Прошло три года

― Интеграция с учебным курсом и другими типами документов

― Единое место хранения исходников и конечных документов

― Никаких вопросов типа «Версия актуальная?» и «Где брать гайды?»

― Единство терминологии

― Легко сделать «почти такую же» документацию

― Style Guide

Плюсы для локализации

― Экономим на переводе

― Экономим на поддержке

― Нет проблем с единством терминологии

― Единое место хранение исходников и конечных документов

― Понятно вообще где что лежит

Недостатки

―Много подготовительной работы

― Затраты на внедрение специализированного ПО

― Затраты на обучение сотрудников

Конец рассказаСпасибо за внимание

Светлана Нудель

snudel@ptsecurity.com

руководитель отдела разработки технической документации

Positive Technologies