Большой yaml файл, достаточно сложно поддерживать. К тому же становится невозможно разрабатывать несколько фичей параллельно, создавая несколько пул реквестов, из-за появления постоянных конфликтов.
Swagger-editor не поддерживает резолвинг относительных путей - issue.
Пример с решением - данное решение не подходит, так как референцы резолвятся на лету. Необходимо заранее собрать все yaml файлы в один и только после этого запускать swagger-editor.
swagger-cli бандлид пример из ветки issue/6-ref-test без ошибок.
Возможно мы могли бы запускать подобный скрипт или библиотеку на каждое изменение и использовать сбандленный файл.
Для решения не должен использоваться никакой серверный фреймворк, так как данный проект в дальнейшем будет хоститься как статический сайт.
Если такого решения нет, то можно использовать express и хостить на хероку.
Большой yaml файл, достаточно сложно поддерживать. К тому же становится невозможно разрабатывать несколько фичей параллельно, создавая несколько пул реквестов, из-за появления постоянных конфликтов.
Документация "Using $ref"
Swagger-editor не поддерживает резолвинг относительных путей - issue.
Пример с решением - данное решение не подходит, так как референцы резолвятся на лету. Необходимо заранее собрать все yaml файлы в один и только после этого запускать swagger-editor.
swagger-cli
бандлид пример из веткиissue/6-ref-test
без ошибок.Возможно мы могли бы запускать подобный скрипт или библиотеку на каждое изменение и использовать сбандленный файл.
Для решения не должен использоваться никакой серверный фреймворк, так как данный проект в дальнейшем будет хоститься как статический сайт. Если такого решения нет, то можно использовать express и хостить на хероку.