请教各位写接口文档时用的 wiki 系统是什么? - V2EX
V2EX = way to explore
V2EX 是一个关于分享和探索的地方
Sign Up Now
For Existing Member  Sign In
Marser

请教各位写接口文档时用的 wiki 系统是什么?

  •  
  •   Marser Nov 8, 2016 8555 views
    This topic created in 3456 days ago, the information mentioned may be changed or developed.

    请教各位写接口文档时,用的 wiki 系统是什么?公司自己开发的?还是使用的开源系统? 有没有开源的 wiki 系统推荐?最好是 php 开发的, node 的也接受~

    12 replies    2016-11-09 10:53:10 +08:00
    66beta
        1
    66beta  
       Nov 8, 2016
    什么? PHP ?

    Phabricator
    bugsnail
        2
    bugsnail  
       Nov 8, 2016
    apidoc

    就是注释写的有点麻烦
    Marser
        3
    Marser  
    OP
       Nov 8, 2016
    @66beta 这是代码审查工具吧?
    xfspace
        4
    xfspace  
       Nov 8, 2016 via Android
    自己做一个...
    Markdown ,用 Elasticsearch 做搜索。
    Marser
        5
    Marser  
    OP
       Nov 8, 2016
    @xfspace 好 6
    Marser
        6
    Marser  
    OP
       Nov 8, 2016
    @bugsnail 好的,谢谢
    glasslion
        7
    glasslion  
       Nov 8, 2016
    1. 文档不应和代码分离。 放在外部 wiki ,容易忘记维护 。
    2. wiki 语法太复杂。一般说明性的文档用 markdown 就足够了, 用 gitlab, Phabricator 查看起来很方便
    3. REST API 接口 用 swagger , 这已成为事实标准
    morewe
        8
    morewe  
       Nov 8, 2016
    自己写了个。
    jininij
        9
    jininij  
       Nov 8, 2016 via Android
    dokuwiki 。无数据库,插件丰富,语法简单完整。
    yubang
        10
    yubang  
       Nov 8, 2016
    自己造一个轮子,能看就好
    66beta
        11
    66beta  
       Nov 9, 2016
    @Marser 有 wiki 功能的,一步到位
    Marser
        12
    Marser  
    OP
       Nov 9, 2016
    @66beta 好的,谢谢~~
    About     Help     Advertise     Blog     API     FAQ     Solana     947 Online   Highest 6679       Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 66ms UTC 22:41 PVG 06:41 LAX 15:41 JFK 18:41
    Do have faith in what you're doing.
    ubao msn snddm index pchome yahoo rakuten mypaper meadowduck bidyahoo youbao zxmzxm asda bnvcg cvbfg dfscv mmhjk xxddc yybgb zznbn ccubao uaitu acv GXCV ET GDG YH FG BCVB FJFH CBRE CBC GDG ET54 WRWR RWER WREW WRWER RWER SDG EW SF DSFSF fbbs ubao fhd dfg ewr dg df ewwr ewwr et ruyut utut dfg fgd gdfgt etg dfgt dfgd ert4 gd fgg wr 235 wer3 we vsdf sdf gdf ert xcv sdf rwer hfd dfg cvb rwf afb dfh jgh bmn lgh rty gfds cxv xcv xcs vdas fdf fgd cv sdf tert sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf shasha9178 shasha9178 shasha9178 shasha9178 shasha9178 liflif2 liflif2 liflif2 liflif2 liflif2 liblib3 liblib3 liblib3 liblib3 liblib3 zhazha444 zhazha444 zhazha444 zhazha444 zhazha444 dende5 dende denden denden2 denden21 fenfen9 fenf619 fen619 fenfe9 fe619 sdf sdf sdf sdf sdf zhazh90 zhazh0 zhaa50 zha90 zh590 zho zhoz zhozh zhozho zhozho2 lislis lls95 lili95 lils5 liss9 sdf0ty987 sdft876 sdft9876 sdf09876 sd0t9876 sdf0ty98 sdf0976 sdf0ty986 sdf0ty96 sdf0t76 sdf0876 df0ty98 sf0t876 sd0ty76 sdy76 sdf76 sdf0t76 sdf0ty9 sdf0ty98 sdf0ty987 sdf0ty98 sdf6676 sdf876 sd876 sd876 sdf6 sdf6 sdf9876 sdf0t sdf06 sdf0ty9776 sdf0ty9776 sdf0ty76 sdf8876 sdf0t sd6 sdf06 s688876 sd688 sdf86