快速生成api文档,支持c#,nodejs,java,php等多种语言
快速生成api文档,支持c#,nodejs,java,php等多种语言 http://www.icafebolger.com/nodejs/nodeapidoc.html
3 回复
比起 https://swagger.io/ 的优势是?
@atian25 优势不敢说,我也不太了解swagger,The Platform for Designing and Documenting APIs with Swagger,这个官网的说明,它旨在api的设计和文档,是个平台框架。而apidoc只关注文档生成,速度快,且生成的文档符合我们的要求,简洁明了而且还支持在线curl请求测试接口
实践告诉我如果在注释里写api的文档,很快会变成一坨难以维护的。。。。。unko
函数的还好,毕竟参数结构不多。而api为了适应前端需求,经常结构很复杂,还要一堆说明,之前上学的时候课设规模都。。。
前天有人给了思路,从test中生成api文档,不过还没时间去找相关js实践