API文档管理工具【rap2与swagger增强】对比
rap2需要手动添加接口，代码零侵入，支持使用模板mock数据，导出postman（配置环境参数）
swagger增强注解生成接口文档，有侵入性，但是减少手动添加接口工作，不支持mock数据，导出postman（配置环境参数）
使用API文档管理工具，可以有效管理API接口的版本问题，可以导出postman。
在mock数据方面rap2具有优势，但是不是必要的选择，也可以自行模拟更贴合业务场景的数据。
因此，两款API文档管理工具就在于你的项目是否可以接受代码侵入，如果可以，那么可以选择swagger。