用于生成API的文档的选项：
- 托管
- 开源项目 对于RESTful API可以使用apiDoc，aglio，swagger等，对于常规的如类，属性、函数等API可以使用jsDoc，sphinx(python).
- http://apidocjs.com/example/
- https://github.com/tripit/slate (推荐)
- https://github.com/andy0323/api-test (我兄弟健翔写的)
- https://github.com/mapbox/docbox （Docbox is an open source version of Mapbox’s REST API documentation system）
从讨论群里整理的，欢迎大家补充
群友说： https://github.com/mulesoft/api-console 这个算是和 RAML 结合的最好的文档生成器，不过居然连个在线的 Demo 都没有 …
@xwartz mock分2种，1种是测试中mock，比如sinon或factory-girl类似的，第二种是直接server端模拟json，这个随便用nodejs里的web框架都行，分分钟的事儿
不错<br/><br/><a class=“form” href=“https://github.com/shinygang/Vue-cnodejs”>I‘m webapp-cnodejs-vue</a>
很多API doc生成工具生成API文档需要引入第三方依赖，重度依赖在代码里加注解的方式，并且不支持自动化测试RESTful API。
之前习惯用一款名字为 WisdomTool REST Client，它能够基于测试过的历史记录自动生成精美的RESTful API文档。完全不用引入第三方依赖，不用在代码里添加任何注解。完全跟API代码脱离，任何用户即使不了解API代码，也能够使用WisdomTool REST Client生成API文档。并且支持自动化测试RESTful API，输出精美的测试报告。 轻量级的工具，功能却很精悍哦！
https://github.com/wisdomtool/rest-client
Most of API doc tools do not support automated testing.
Once used a tool called WisdomTool REST Client supports automatically generating exquisite RESTful API documentation based on history testing cases without adding annotations to the code, it also supports automated testing, and outputs exquisite report.
Lightweight tool with very powerful features!
