Swagger Spring-MVC描述参数不受@Api注释的尊重

Question

我试图使用swagger spring-mvc（https://github.com/martypitt/swagger-springmvc）为我的java spring MVC API自动生成文档。

为什么我的@Api注释没有使用描述？我正在使用（com.wordnik.swagger.annotations.Api）。这是我控制器中的@Api声明：

@Api(value = "hierarchies", description = "Hierarchies Resource")

以及来自/ api-docs /的结果JSON：

{"path":"/v1/hierarchies","description":"hierarchies"}

即使是昂首阔步的在线演示也会显示说明有效：

http://petstore.swagger.wordnik.com/

在JSON中，它显示： {＆＃34;路径＆＃34;：＆＃34; / pet＆＃34;，＆＃34;说明＆＃34;：＆＃34;关于宠物的操作＆＃34;}

似乎文档引擎忽略了描述字段，无论我输入什么，只是使用描述的值。我在swagger-springmvc做错了什么？我需要使用不同的注释吗？这只是swagger-spring-mvc中的一个错误吗？