做 app 服务器端的朋友们,有啥好的 api 文档写作工具没

2015-12-10 11:11:51 +08:00
 GTim

最近,用了 gitlab 的 wiki 写写写 总感觉欠缺点什么
所以来看看大家都用什么工具

4692 次点击
所在节点    程序员
21 条回复
hging
2015-12-10 11:15:12 +08:00
swagger
hao123yinlong
2015-12-10 11:25:53 +08:00
apidoc.js
globit
2015-12-10 11:40:06 +08:00
ixiaozhi
2015-12-10 11:46:31 +08:00
我用的 mweb 写 Markdown 的 估计没有其他人了吧
janxin
2015-12-10 11:54:59 +08:00
apiary.io ,说实话并不太好使....swagger 就是嫌写起来太麻烦
freeznet
2015-12-10 11:55:07 +08:00
@ixiaozhi 我也在用 mweb 和自带的 foundation-book 主题写文档
csensix
2015-12-10 11:57:06 +08:00
MkDocs
felixzhu
2015-12-10 12:15:51 +08:00
mkdocs
gitbook
jerray
2015-12-10 13:13:01 +08:00
随便搞个支持 Markdown 的编辑器,然后用 API Blueprint https://apiblueprint.org/ 。写起来感觉十分流畅。
keepcleargas
2015-12-10 13:27:57 +08:00
slate https://github.com/tripit/slate, 可读性强,导航方便.
hongcha
2015-12-10 13:36:23 +08:00
gitbook 太完美了
TangMonk
2015-12-10 13:44:52 +08:00
@janxin rails-swagger 自动生成
angryRabbit
2015-12-10 17:54:28 +08:00
swagger 用起来有些复杂,现在最流行的文档工具好像是 word 。。。
GTim
2015-12-10 23:06:43 +08:00
@keepcleargas 看起来好漂亮
smilebaby
2015-12-11 09:40:21 +08:00
MdCharm 桌面编辑器
kkwezard
2015-12-11 09:44:46 +08:00
python 后端,直接从 doc_string 用 sphinx 生成的。
stdying
2015-12-11 17:58:02 +08:00
我公司,文档残缺
GTim
2015-12-11 18:20:26 +08:00
all 谢谢各位,如果有更好的文档工具都分享分享,暂时先用 swagger
imNull
2015-12-16 19:18:56 +08:00
有人用这个么, easyapi ,但似乎功能不多
hpu423
2016-03-16 09:46:22 +08:00

这是一个专为移动设备优化的页面(即为了让你能够在 Google 搜索结果里秒开这个页面),如果你希望参与 V2EX 社区的讨论,你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://www.v2ex.com/t/242471

V2EX 是创意工作者们的社区,是一个分享自己正在做的有趣事物、交流想法,可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.

© 2021 V2EX