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