比起 https://swagger.io/ 的优势是？

@atian25 优势不敢说，我也不太了解swagger，The Platform for Designing and Documenting APIs with Swagger，这个官网的说明，它旨在api的设计和文档，是个平台框架。而apidoc只关注文档生成，速度快，且生成的文档符合我们的要求，简洁明了而且还支持在线curl请求测试接口

实践告诉我如果在注释里写api的文档，很快会变成一坨难以维护的。。。。。unko

函数的还好，毕竟参数结构不多。而api为了适应前端需求，经常结构很复杂，还要一堆说明，之前上学的时候课设规模都。。。

前天有人给了思路，从test中生成api文档，不过还没时间去找相关js实践