用swagger2 ，维护API文档很麻烦吗？返回值无法说明？ --- 还是没用对方法？

之前在和一些技术同事聊到了接口文档这事，并提到了swagger，收到的反馈有这些：

“很麻烦！接口文档要和代码耦合在一起”

“字段说明要写好几遍！一改要改好多地方！”

"请求参数想描述清楚要写一堆玩意儿！！"

 

我也看了下，控制器方法上要对每个参数这么描述，确实有点反人类啊！

@ApiImplicitParams({
    @ApiImplicitParam(name="mobile",value="手机号",required=true,paramType="form"),
    @ApiImplicitParam(name="password",value="密码",required=true,paramType="form"),
    @ApiImplicitParam(name="age",value="年龄",required=true,paramType="form",dataType="Integer")
})

并且对于返回值，往往大多的示例都是封装了一个响应对象，类似：

@Data
public class RespData{
	public static final int Success = 1;
	public static final int Error = 0;
	
	private int status;
	private Object da