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

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

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

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

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

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

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

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

Войти через TM ID
Похожие вопросы