接口文档修改问题分析

问题价值：
1.在实际中，经常出现接口本身的增删改查，参数的修改和添加删除，返回值的变化和修改；
2.前后端分离，接口文档是一种非常重要的前后端人员沟通的媒介 ，但是接口文档又具有版本时效性的特点；
3.公司人员的流入流出，新人对项目接口的理解需要借助尽可能的接口文档，特别是对参数的description, 不然一种领域的系统，可能因为对领域参数的不了解，造成对效率的影响

技术选型分析：
1.swagger 的问题就是注解太多，导致项目代码耦合了太多接口文档相关代码，但是和springboot适配性好
2.postman,借助第三方工具，利用postman 的团队模式，将接口文档共享，使之降低对项目的依赖