背景 我们在项目开发完成，接口写好后，需要将接口文档给到前端同学，或者合作方的工程师。但 swagger 对接口阅读并不友好，大部分情况下还得把...

一些刚开始写接口文档的服务端同学，很容易按着代码的思路去编写接口文档，这让客户端同学或者是服务对接方技术人员经常吐槽，看不懂接口文档。这篇文章提...