IT

Мини-Гипербатон: технология DITA

В московском офисе Яндекса пройдёт очередная встреча технических писателей. В этот раз мероприятие будет посвящено технологии DITA.

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

Опытом и знаниями поделится команда Яндекса и Михаил Острогорский из компании «Философт». После выступлений вы сможете пообщаться с докладчиками и другими участниками за чашкой чая.

Дата мероприятия: 11 декабря 2017 года, Москва, Россия

Ключевые темы мероприятия

Кто и для чего использует DITA

Технология DITA выглядит сложнее многих других средств разработки технический документации. Для её внедрения придется приложить немало усилий. В докладе будет приведён краткий обзор мотивов и средств применения этой технологии на практике.

Автоматическая редактура DITA-документов c помощью Schematron

Для многих языков разметки есть способы облегчить редактуру на этапе написания текста. Для DITA и прочих XML-документов в этом может помочь Schematron. В докладе мы рассмотрим простые примеры самописных сценариев валидации и поговорим о способах их внедрения в процесс написания документации.

Информационная архитектура технической документации: как правильно использовать технологию DITA

Когда нужно использовать conref, а когда — conkeyref? Или для проекта достаточно профилирования? За время существования DITA накопилось большое количество разнообразных возможностей, подходов к организации контента, а также конкретных механизмов их реализации. Запутаться в них немудрено, и это часто приводит к появлению непонятных, неэффективных и просто неудобных решений по автоматизации документирования. В докладе я постараюсь разложить всё по полочкам. Мы обсудим несколько типичных случаев из практики, поговорим о том, каким образом в каждом из них должен быть организован контент и какие именно возможности DITA при этом следовало бы использовать. Рассмотрим распространённые ошибки. В итоге мы придем к понятию информационной архитектуры технической документации, её роли при использовании технологии DITA и подходам к её проектированию.

Моя DITA

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

Как принять участие

Участие бесплатное, но количество мест ограничено. Чтобы встреча прошла наиболее продуктивно, отбор проводится с учётом опыта и интересов зарегистрировавшихся. Те, кто не попадёт на встречу, смогут потом посмотреть доклады в записи.

Для регистрации пройдите по ссылке и заполните форму.

Место проведения

Москва, ул. Льва Толстого, 16

Конференц-зал «Мулен Руж»


Источник материала: