V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
GTim
V2EX  ›  程序员

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

  •  
  •   GTim · 2015-12-10 11:11:51 +08:00 · 4687 次点击
    这是一个创建于 3058 天前的主题,其中的信息可能已经有所发展或是发生改变。

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

    21 条回复    2016-10-27 17:35:27 +08:00
    hging
        1
    hging  
       2015-12-10 11:15:12 +08:00
    swagger
    hao123yinlong
        2
    hao123yinlong  
       2015-12-10 11:25:53 +08:00
    apidoc.js
    globit
        3
    globit  
       2015-12-10 11:40:06 +08:00   ❤️ 2
    ixiaozhi
        4
    ixiaozhi  
       2015-12-10 11:46:31 +08:00
    我用的 mweb 写 Markdown 的 估计没有其他人了吧
    janxin
        5
    janxin  
       2015-12-10 11:54:59 +08:00
    apiary.io ,说实话并不太好使....swagger 就是嫌写起来太麻烦
    freeznet
        6
    freeznet  
       2015-12-10 11:55:07 +08:00
    @ixiaozhi 我也在用 mweb 和自带的 foundation-book 主题写文档
    csensix
        7
    csensix  
       2015-12-10 11:57:06 +08:00
    MkDocs
    felixzhu
        8
    felixzhu  
       2015-12-10 12:15:51 +08:00
    mkdocs
    gitbook
    jerray
        9
    jerray  
       2015-12-10 13:13:01 +08:00
    随便搞个支持 Markdown 的编辑器,然后用 API Blueprint https://apiblueprint.org/ 。写起来感觉十分流畅。
    keepcleargas
        10
    keepcleargas  
       2015-12-10 13:27:57 +08:00   ❤️ 2
    slate https://github.com/tripit/slate, 可读性强,导航方便.
    hongcha
        11
    hongcha  
       2015-12-10 13:36:23 +08:00
    gitbook 太完美了
    TangMonk
        12
    TangMonk  
       2015-12-10 13:44:52 +08:00
    @janxin rails-swagger 自动生成
    angryRabbit
        13
    angryRabbit  
       2015-12-10 17:54:28 +08:00
    swagger 用起来有些复杂,现在最流行的文档工具好像是 word 。。。
    GTim
        14
    GTim  
    OP
       2015-12-10 23:06:43 +08:00
    @keepcleargas 看起来好漂亮
    smilebaby
        15
    smilebaby  
       2015-12-11 09:40:21 +08:00
    MdCharm 桌面编辑器
    kkwezard
        16
    kkwezard  
       2015-12-11 09:44:46 +08:00
    python 后端,直接从 doc_string 用 sphinx 生成的。
    stdying
        17
    stdying  
       2015-12-11 17:58:02 +08:00
    我公司,文档残缺
    GTim
        18
    GTim  
    OP
       2015-12-11 18:20:26 +08:00
    all 谢谢各位,如果有更好的文档工具都分享分享,暂时先用 swagger
    imNull
        19
    imNull  
       2015-12-16 19:18:56 +08:00
    有人用这个么, easyapi ,但似乎功能不多
    hpu423
        20
    hpu423  
       2016-03-16 09:46:22 +08:00
    sinux
        21
    sinux  
       2016-10-27 17:35:27 +08:00
    @hongcha 慢得出奇,而且不能在线编辑,美什么......
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   我们的愿景   ·   实用小工具   ·   5443 人在线   最高记录 6543   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 30ms · UTC 06:43 · PVG 14:43 · LAX 23:43 · JFK 02:43
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.