这是一个创建于 3549 天前的主题，其中的信息可能已经有所发展或是发生改变。
我目前拿到的 api 文档大部分都是 word
 |
1
silencewwt 2016 年 5 月 3 日
Sphinx, 然后生成 `read the docs` 风格的 html
|
 |
2
ewBuyVmLZMZE 2016 年 5 月 3 日
是时候安利 swagger 了
|
 |
3
Victor215 2016 年 5 月 3 日 via Android
我们用 markdown
|
 |
4
crysislinux 2016 年 5 月 3 日
raml ， execl 也比 word 要好吧，其实我觉得 execl 也还可以。。。
|
 |
5
lecher 2016 年 5 月 3 日 via Android
偷懒的时候直接写个接口专门扫文件，然后输出注释就显示，这样给前端一个 Web 接口就可以看所有注释了。
好处是只需要维护一份文档，方便实时更新，把注释写好就行，坏处太多列不完，文档不规范，没有格式等等一堆工程化要求没有达到 |
 |
6
yellowV2ex 2016 年 5 月 3 日  5
我最近用了一个牛逼的东西，然后报价可以多报个一两千，这就是逼格的价值。
用 aglio 生成文档 https://github.com/danielgtaylor/aglio ，原始格式是基于 markdown 的 API Blueprint https://apiblueprint.org/ 生出来的东西大概是这样子的： http://htmlpreview.github.io/?https://raw.githubusercontent.com/danielgtaylor/aglio/blob/master/examples/default.html 以及三列版 http://htmlpreview.github.io/?https://raw.githubusercontent.com/danielgtaylor/aglio/blob/master/examples/default-triple.html |
 |
7
pepsin 2016 年 5 月 3 日
Paw 改改 JS 生成的也不错
|
 |
8
odirus 2016 年 5 月 3 日
表示强烈关注
|
 |
9
fwrq41251 2016 年 5 月 3 日 1
推荐 miredot,个人觉得比 swaggeer 好用。
|
 |
12
gucheen 2016 年 5 月 3 日
swagger 和 markdown 搭配
|
 |
13
Drifter 2016 年 5 月 3 日 1
1 ，做过接口扫描+接口注释输出。
优点是只用维护一份文档； 缺点是页面比较简单，不好定制； 2 ，现在使用的 pelican+某个主题 优点是生成快，不用管文档结构，只写文档； 缺点是主题不好找，不好作内部链接引用。 想尝试用 sphinx+read the doc ，但是 rst 的复杂写法让我望而却步了。 |
 |
14
tadtung 2016 年 5 月 3 日
gitbook 好些吧，，虽然之前我自己也写过，，，不过还是多用 gitbook
|
 |
15
roys 2016 年 5 月 3 日
swagger ＋ 1
|
 |
16
rainysia 2016 年 5 月 3 日
swagger + 1
|
 |
17
ferstar 2016 年 5 月 3 日
mark 下, 表示准备用 swagger
|
 |
18
kenshinhu 2016 年 5 月 3 日
因为主要用 node,所以用 apidoc 来生成文档
|
 |
19
cookit 2016 年 5 月 3 日
confluence wiki
|
 |
20
Oceanz 2016 年 5 月 3 日
https://github.com/thx/RAP 感觉还可以。
|
 |
21
hjxx 2016 年 5 月 10 日
swagger 自动生成了
|
Select Language