你们团队都是怎么管理 API 文档的

[jimyan]

api   文档是用 wiki 还是 doc

[zhuf]

swagger+1

[mckelvin]

https://apiblueprint.org/ 用 atom 加插件写类似 Markdown 的语法，用 Aglio 渲染成 html 文档, 顺手用 Drakov 生成 mock server 方便前后端分离开发。

[kankana]

apizza.cc 用的是这个。 postman 后直接文档

[caixiexin]

用 swagger 可以保持接口跟文档同时更新，但是如果用接口生成文档的方式，源代码会有很多原来放在文档里的说明信息。
不管哪种方式，写文档的工作是省不掉的😂

[firstfire]

代码里用 Javadoc
API 文档用 Markdown 写用 SVN 管理版本

[sobigfish]

OpenAPI / Swagger

[argon33]

文档的维护太难了。。。放在代码库里？

[settings]

@klgd 版本间的比较指的是文档更新后的对比吗？

[geeksu]

我们的 API 没有文档。。

[AJian]

用过 RAP

[Ixizi]

目前在用 RAP 虽然不喜欢 java

[Jackeriss]

@ixiaozhi 神圣的 F2 连着我们的思想

[loveskyforever]

用的是 SBDoc ，可以内网测试， mock 数据，自动生成文档，干净无插件 http://123.57.77.6

[Ypoem]

支持下

[yy1300326388]

postmant

[zorui]

swagger +1

[zorui]

swagger + asciidoc

[v4ex4b]

@SourceMan \(≧▽≦)/

[irory]

推荐自动生成文档, 比如 PY 的 sphinx ， api 更新方便维护 ，一键生成也方便。

[ivanyin]

用 RAP