Документирование RESTful API используя RAML 1.0

Всё что касается построения API
Ответить
Gipperion
Сообщения: 1
Зарегистрирован: 2017.03.01, 12:16

Документирование RESTful API используя RAML 1.0

Сообщение Gipperion »

Мне нужна standalone неинтерактивная документация к RESTful API. Начал документировать с помощью редактора API Designer в формате RAML 1.0. Когда дело дошло до конвертирования в html с помощью raml2html, обнаружил, что тема по умолчанию довольно корявая даже против превью из правой панели редактора. Искал другие темы, но оказалось что их всего три. Найти что-то ещё с помощью гугла не вышло. Неужели, с темами всё так плохо и стоит смотреть в сторону, например, swagger? Кто знает какие он имеет темы и есть ли способ сконвертировать RAML 1.0 в понятный swagger'у формат?
Ответить