Комментарии 2
Интересно было бы узнать:
— почему был выбран DocBook, а не DITA,
— каким XML редактором они пользуются? это что-то CSS based или это обычный XML редактор для разработчика?
А вообще здорово! Как раз сейчас занимаюсь созданием автоматической сборки документации на Jenkins. Но в основе — DITA XML. Соответсвенно, DITA-OT и ant. Использовать maven как-то недогадался. Надо посмотреть на их сборку повнимательнее.
— почему был выбран DocBook, а не DITA,
— каким XML редактором они пользуются? это что-то CSS based или это обычный XML редактор для разработчика?
А вообще здорово! Как раз сейчас занимаюсь созданием автоматической сборки документации на Jenkins. Но в основе — DITA XML. Соответсвенно, DITA-OT и ant. Использовать maven как-то недогадался. Надо посмотреть на их сборку повнимательнее.
Добрый день,
Спасибо за ваш комментарий.
-DocBook был выбран потому, что у изначальной команды авторов был опыт работы с ним;
— В качестве редактора команда советует Oxygen XML, но поскольку он платный, то можно использовать любой другой, желательно с валидацией по схеме;
— Более подробно инструкции по созданию и редактированию документации приведены на wiki.openstack.org/wiki/Documentation/HowTo.
Спасибо за ваш комментарий.
-DocBook был выбран потому, что у изначальной команды авторов был опыт работы с ним;
— В качестве редактора команда советует Oxygen XML, но поскольку он платный, то можно использовать любой другой, желательно с валидацией по схеме;
— Более подробно инструкции по созданию и редактированию документации приведены на wiki.openstack.org/wiki/Documentation/HowTo.
Зарегистрируйтесь на Хабре, чтобы оставить комментарий
Интервью с Анной Джентл (Anne Gentle), координатором разработки документации для сообщества OpenStack