利用apidoc设计文档自动生成方案

使用apidoc 可以通过分析代码中的注释生成文档，由于apidoc生成的文档是一个单文件
多人开发过程中会导致文件的覆盖，可以通过git 代码分支合并的时候通过钩子(web hook)生成文档到文档服务器
文档服务器通过samba 服务 实现代码服务器将生成的文档写入文档服务器。由于是静态文件可以使用node 来跑
这样避免多项目的时候 需要在文档服务器绑定不同的域名来实现单台文档服务器跑多个项目的接口文档的麻烦

阅读全文