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

[jimyan]

api   文档是用 wiki 还是 doc

[zhangliang605]

Confluence 。
是我们是一个 1200+人的团队，面临开发，测试，产品经理，项目经理，运营，商务等等各个部门的协作。 Confluence 能跟公司的通信录系统，邮箱系统对接。当关注的文档发生变化时，立即发送邮件给相关同事。同时， Confluence 支持各种插件，富文本编辑，代码高亮，评论，备注等等功能一应俱全。

[antowa]

我司使用意念传输。精神授权。

[settings]

@klgd 默认不支持，可以反射 markdown ，我们是用 swagger api 反射 markdown ，再把 markdown 提交 git ，通过 gollum 展示 wiki 。

生成 markdown 的脚本： https://github.com/ZhangBohan/swagger_to_markdown

[keepcleargas]

slate + git

[wjh3936]

文档？看代码 [冷漠脸]

[sumuu]

Swagger + Google Drive

[klgd]

@settings 呃~
要这么麻烦哦

[billyu]

我用的 EasyAPI

[caotian]

用的 http://daux.io/，还不错

[settings]

@klgd 恩，是的 :D

[Hypn0s]

Confluence+1

[flowerwrong]

口口想传

[sampeng]

api 是什么东西？可以吃吗？

[airingursb]

rap

[962680038]

SBDoc 不错啊，楼主可以去了解下，操作很简洁，效果很好，链接： http://123.57.77.6/

[dozer47528]

想不收费自己搭建的话，可以使用 https://apiblueprint.org/
它本身提供云服务，但也可以自己搭建。写文档就是写 markdown ， github 也认这种格式。





然后开源社区已经做好了各种工具，包括把 apiblueprint 格式生成 html ， apiblueprint 生成 mock server 等等，非常方便。
我做了个 docker 镜像，只要提供你们写文档的 git 仓库，就可以一键搭建。包含文档服务器， mock server 和 hook api （文档更新的时候自动更新相关内容）
https://github.com/dozer47528/api-blueprint-docker

另外，你可能会需要对静态网站做 oauth2 认证功能，可以利用这个东西： https://github.com/bitly/oauth2_proxy

可以配置邮箱白名单，这样只有你们公司的人能访问了。

[HowToMakeLove]

apidoc

[jsq2627]

个人觉得从测试用例生成文档是体验最棒的文档开发方式。

最近给 node.js 做的轮子，强力推荐一下
https://github.com/stackia/test2doc.js

[yuhanle]

先开大会，再开小会，最后一对一，手把手同步需求

[HuntBao]

可以试试 NEI 接口管理平台： https://nei.netease.com