Springfox Spring Web MVC описание конечной точки

Question

Я использую Springfox в проекте Spring Web MVC без каких-либо пользовательских аннотаций Springfox/Swagger. В пользовательском интерфейсе Swagger (и, конечно же, в генерируемом JSON) описание для конечных точек - это просто имена методов.

Есть ли способ автоматического использования описания, как в комментарии к коду (который является правильно отформатированным комментарием Javadoc).

Answer 1

В Swagger2Markup вы можете написать описания в AsciiDoc и объединить рукописную документацию с вашей сгенерированной документацией.

Я планирую интегрировать https://github.com/asciidoctor/asciidoclet в Swagger2Markup.