Что касается веб-приложения, над которым мы сейчас работаем, нам придется заранее подумать о том, как развернуть его для нескольких различных групп пользователей. С функциональной стороны важно иметь систему документации, которую можно использовать для создания руководства пользователя и контекстно-зависимой справки из одних и тех же исходных файлов.
Мы планировали использовать DITA в качестве системы документации и теперь думаем о простом и расширяемом способе, позволяющем разработчикам указывать элементы, которые предоставляют контекстно-зависимую справку и могут быть заполнены техническими писателями и инструкторами.
На основе DITA мы хотели бы создать руководство пользователя в формате PDF и контекстно-зависимую справку, интегрированную в веб-приложение на основе JSP. Какие у вас есть рекомендации?
Мы уже находимся в процессе оценки коммерческого приложения, которое имеет следующие функции
- инструмент разработки для определения элементов на веб-странице, которые будут заполнены справочной информацией
- интеграция с системами управления обучением
- поддержка приложений, которые не являются веб-приложениями
Есть ли у вас рекомендации по фреймворку? В дополнение к вышеперечисленному, было бы здорово следующее
- интегрироваться с DITA (любым мыслимым способом)
- Контент, специфичный для группы пользователей (пользователь, полученный из веб-приложения)
- может использоваться из простого веб-приложения для отображения подсказок (html)
- связь контекста справки со следующей иерархией: приложение > страница > элемент (идентификатор HTML?)