V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
• 请不要在回答技术问题时复制粘贴 AI 生成的内容
yemoluo
V2EX  ›  程序员

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

  •  
  •   yemoluo · 2015 年 12 月 10 日 · 5304 次点击
    这是一个创建于 3692 天前的主题,其中的信息可能已经有所发展或是发生改变。

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

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