north_leshiy
@north_leshiy
Руководитель направления разработки

Обладает ли преимуществами RAML перед SWAGGER (Open Api) в 2018 году?

Выбирая систему документации, выбрали RAML, ввиду обещания меньшего дублирования.

Однако обратил внимание что по RAML очень мало СВЕЖЕЙ документации и статей, инструменты которые были для него разработаны очень многие не развивались уже 2-3+ года, 1.0 версия поддерживается слабо инструментами (в т.ч. для PostMan пришлось генерировать RAML=>Swagger).

Swagger еще не пользовались, только погружаемся в системы документации.

В связи с этим вопрос: имеет ли смысл использовать RAML в 2018, возможно SWAGGER уже пофиксил те недостатки из-за которых создался RAML как более расширенная альтернатива?
  • Вопрос задан
  • 431 просмотр
Решения вопроса 2
neatsoft
@neatsoft
Life is too short for bad software
RAML - top-down, Swagger - bottom-up, они совершенно разные.

Использую Swagger для автоматического создания документации на основе кода и комментариев. Есть некоторые шероховатости, но в целом всё работает. Позволяет экономить уйму времени, и легко поддерживать документацию в актуальном состоянии.
Ответ написан
Раньше RAML был интереснее за счёт развитой системы типов данных: ЕМНИП, ранее первые версии сваггера/openapi поддерживали только встраивание JSON-схемы, теперь же вроде OpenAPI доразвился в этом плане, так что он выглядит сопоставимым по возможностям, но значительно менее рисковым.
Ответ написан
Пригласить эксперта
Ваш ответ на вопрос

Войдите, чтобы написать ответ

Войти через центр авторизации
Похожие вопросы