4. Проблемы с выпуском документации
• Разрозненная документация
• Один документ в одном файле
• Сложности командной работы
• Текстовый редактор вместо
специализированного ПО
• Невозможно повторно использовать
контент
www.docsvision.com Слайд: 4
5. Почему технология единого источника?
• Много форматов из одного исходника
(xhtml, chm, pdf и другие)
• Одновременная работа нескольких
техписателей над одним проектом
• Повторное использование контента
www.docsvision.com Слайд: 5
13. Почему именно DITA?
• Использования любого редактора с
поддержкой DITA
• Жестко определенная структура документа
• Унификация текста внутри раздела
• Компоновка итогового документа под
конкретного Заказчика
www.docsvision.com Слайд: 13
15. Стандарт документации компании
• Типы выпускаемых документов
Руководство пользователя, администратора и т.д.
• Структуру выпускаемых документов
Разделы документов
• Состав элементов структуры
Наполнение разделов
www.docsvision.com Слайд: 15
17. Формат, локализация, нумерация
• Утверждение набора выходных форматов
• Определение необходимости локализации
и набора языков
• Нумерация версий продукта и версий
документа
www.docsvision.com Слайд: 17
19. Подготовка макетов дизайна
• Количество видов стилевого оформления
• Соответствие Style Guide
• Разработка макетов дизайна для каждого
из выходных форматов (pdf, xhtml и тп)
• Утверждение макетов дизайна для каждого
вида документа
www.docsvision.com Слайд: 19
23. Настройка вывода
• Привлечение сторонних специалистов
• Настройка DITA OT для каждого из
форматов вывода
• Тестирование настроек и решение проблем
www.docsvision.com Слайд: 23
25. Сложность организации хранилища
• Необходимость разделения исходных
файлов и готовых документов
• Создание репозитория, единого для всех
техписателей
• Хранение исходных файлов для автосборки
справок
• Хранение версий готовых документов
www.docsvision.com Слайд: 25
28. Сложности обучения техписателей
• Изменить мышление – переход с учебника
на справочник
• Обучение работе в текстовом редакторе
• Изучение типового набора DITA тегов
• Подбор персонала
www.docsvision.com Слайд: 28