api-document:java spring-mvc文件收集

中文说明 | | 说明 维护过项目的人应该都有体会, 如果接口文档是单独编写的(org-mode、markdown、rap 甚至是 word 等), 随着项目周期的推进, 接口文档和真实代码之间的差距会越来越远. 基于 swagger 的一些细节不那么让人如意(比如无法处理 map, swagger-ui 中查看响应说明需要切屏, 把脑袋理解成是一台计算机, 眼睛是输入设备, 在看到返回的 json 时, 眼球会自己 parse 成对应的对象, 这时候你还无法确定各个字段的说明, 得切屏才能知道, 脑子会想办法把两者关联起来, 但是同一时间只能看到一个, 且切屏后的说明跟原来的排列并不一致, 于是只能不停的切, 这会加重将两者关联起来的心智负担)而出现了此文档收集应用. 使用 添加引用 <dependency> <groupId>com.github.liuanxin