爱意满满的作品展示区。
balabalaguguji

我们出新产品啦,专业漂亮的 API 文档系统

  •  
  •   balabalaguguji · Nov 20, 2018 · 9633 views
    This topic created in 2909 days ago, the information mentioned may be changed or developed.

    我是技术出生的,一直梦想自己能做点产品出来,不过我想到的产品都是跟技术相关的,这类产品一般属于小众,也赚不到什么钱,所以一般很少人去做好它,但是作为一个技术人员的情怀,我觉得有必要去用心做好它,创业一年多了,终于我们上新产品啦。这次我们要解救开发人员编写文档的痛苦。

    我们的产品叫易文档: https://easydoc.xyz ,支持在线接口测试、自定义文档模板、预定义常用参数、分享文档。现在还是 beta 版,可能存在一些问题,大家可以跟我们反馈,我们会进行完善升级。

    为什么我会选择做这个? 我们公司是外包+自研产品模式,经常需要些一些接口文档和使用手册,网上找过很多个,都不满意,所以我们决定自己做一套了。

    我见过很多公司写接口文档还在用 word,excel,txt,要我用这种写接口文档,我是很痛苦的,首先是编写起来很麻烦,格式要编排好很费力,出来的文档也不漂亮,查找接口又麻烦,另外每次修改了一点东西,都要重新同步给协作者。 当然还有的公司直接就文档都不写,两个人直接坐在一起开发,直接口头传播,当然没问题,但是如果下个人接手你的项目,他就得看代码去了解接口有哪些参数了。

    欢迎大家体验,给我们提建议,我们的目标是做最好的用的在线文档管理系统

    Supplement 1  ·  Nov 20, 2018
    第三方登录已经改为直接进入了
    Supplement 2  ·  Nov 21, 2018
    有人说为什么我们要重复造轮子,因为现在的轮子不够好,不满足我们的高要求。
    我们做过很多调查,API 文档这块,体验做的好的,符合要求的,我是一个都没找到。
    我说下我们对 API 文档的要求:
    1.编写体验要好,不需要动鼠标,写完一个 tab 一下就下一个
    2.支持参数行顺序调整,拖动就能调整
    3.支持子参数,因为参数经常是有字典类型的
    4.可以随意增加 /删除参数块,比如我不需要头部参数,我可以删除;我可以添加成功时返回什么参数,失败时又返回什么参数
    5.可以自定义说明,比如我想在请求参数后面添加一个特别说明,或者示例,我可以随时增减,并且随时调整顺序
    6.可以在线测试接口
    7.预览页要很漂亮,点击就能自动复制 url,参数名等
    8.文档列表可以进行分类,调整顺序,搜索
    9.可以随时分享文档给朋友,可以设置密码、失效时间
    10.完成开发后,还需要支持写部署文档,使用手册

    以上我们说的要求,你们要是能找到任何一个其他文档系统能满足,算我输。
    我们的文档系统是全部满足以上要求的,因为我自己是做开发的,对这类产品的理解比较深,要求也比较高,希望开发人员能有个更好的文档体验
    77 replies  •  2018-11-27 19:36:30 +08:00
    scofieldpeng
    scofieldpeng
    Nov 20, 2018
    1
    建议出一个开源自部署,可能还会火
    Tierney
    Tierney
    Nov 20, 2018
    2
    友情帮顶+1,看起来很舒服
    Chappako
    Chappako
    Nov 20, 2018
    3
    支持一下,加油
    anakinsky
    anakinsky
    Nov 20, 2018
    4
    🐮B 顶一下
    twor
    twor
    Nov 20, 2018
    5
    预览有 bug ? 点击没有内容
    yuedingwangji
    yuedingwangji
    Nov 20, 2018
    6
    看起来不错, 跟 yapi 比起来有什么特点么
    CopyRight
    CopyRight
    Nov 20, 2018
    7
    秒关了三方登录授权成功后的页面。
    qiayue
    qiayue
    Nov 20, 2018
    8
    去掉测试功能,或者测试功能改成可配置为用户自己的测试环境接口,然后收费(或免费)提供可以自部署安装版本
    nekoneko
    nekoneko
    Nov 20, 2018
    9
    不错,能自部署会更好
    balabalaguguji
    balabalaguguji
    OP
    Nov 20, 2018
    10
    @scofieldpeng #1 等我们产品完善好后,会提供免费私有部署版本的
    4DAX07B8Kle4Dm6T
    4DAX07B8Kle4Dm6T
    Nov 20, 2018
    11
    看着还可以
    balabalaguguji
    balabalaguguji
    OP
    Nov 20, 2018
    12
    @yuedingwangji #6 我们比他们更加专业,编写体验更好,预览更漂亮
    fengpan567
    fengpan567
    Nov 20, 2018
    13
    为什么用 QQ 登录了还要绑定邮箱。、。。。。。。。。
    kulove
    kulove
    Nov 20, 2018
    14
    xyz 这后缀..看着就感觉不专业..没有 com cn,也不能用 xyz 吧..
    balabalaguguji
    balabalaguguji
    OP
    Nov 20, 2018
    15
    @fengpan567 #13 因为邮箱是用来添加好友用的,不设置邮箱不好找人
    zhangalong69
    zhangalong69
    Nov 20, 2018
    16
    为什么微信登录了还要绑邮箱设置密码呀,这一步会劝退不少人
    lepig
    lepig
    Nov 20, 2018
    17
    别用 xyz, 真的很业余。
    balabalaguguji
    balabalaguguji
    OP
    Nov 20, 2018
    18
    @zhangalong69 #16 嗯,刚开始是考虑到要添加成员时需要用邮箱来查找,我们稍后去掉这步
    zifangsky
    zifangsky
    Nov 20, 2018
    19
    看了一下,功能界面都挺好,不过一些明显的 BUG 后面还要再改改,另外提个建议:写好的文档可以导出成 PDF 离线文档。
    lniwn
    lniwn
    Nov 20, 2018
    20
    简单体验了下,最大的感受就是登陆过程一头雾水,明明用微信提示登陆成功了,结果还弹出帐号密码界面。不过界面和内容不错,慢慢完善,应该是个不错的产品。
    CEBBCAT
    CEBBCAT
    Nov 20, 2018 via Android
    21
    又是一个被发帖 bug 坑到发错节点的帖子 @Livid
    Livid
    Livid
    MOD
    PRO
    Nov 20, 2018 via iPhone
    22
    @CEBBCAT 什么 bug ?能否稍微描述一下?
    Livid
    Livid
    MOD
    PRO
    Nov 20, 2018 via iPhone
    23
    aaronnum7
    aaronnum7
    Nov 20, 2018
    24
    文档里面,表格的下边框和表头阴影没有对齐,有点强迫症。。。
    balabalaguguji
    balabalaguguji
    OP
    Nov 20, 2018
    25
    @Livid 我想把它放在分享创造那里的
    Cbdy
    Cbdy
    Nov 20, 2018 via Android
    26
    xyz,挺好的,也很专业,参考字母表公司
    建议兼容 swagger 的 api doc 标准
    megachweng
    megachweng
    Nov 20, 2018 via iPhone
    27
    和小幺鸡比起来有什么优势
    duola
    duola
    Nov 20, 2018
    28
    这个可以有,我试一下。
    balabalaguguji
    balabalaguguji
    OP
    Nov 20, 2018
    29
    @megachweng #27 我们比小幺鸡体验好太多了,不管是编写体验还是预览,你试下就知道了
    longjiahui
    longjiahui
    Nov 20, 2018
    30
    再把功能完善一下,非常不错!
    icella
    icella
    Nov 20, 2018 via Android
    31
    敢问兄弟 你这个怎么跟 MinDoc 功能和长相都差不多呢 人家是开源的
    laike9m
    laike9m
    Nov 20, 2018 via Android
    32
    出身,不是出生
    hash
    hash
    Nov 20, 2018
    33
    看到说 xyz 域名业余,Alphabet 真是泪流满面.
    icella
    icella
    Nov 20, 2018 via Android
    34
    @Chappako 建议看一下那个开源的 MinDoc 总感觉这个推广的跟人家一模一样😛
    balabalaguguji
    balabalaguguji
    OP
    Nov 20, 2018
    35
    @icella #31 你认真看下我们的,对比下,我们的可以说各方面都比你说的 MinDoc 做的更优秀
    Kilerd
    Kilerd
    Nov 20, 2018
    36
    那个蓝色的边栏,真的不是抄袭 readthedocs 吗?
    icella
    icella
    Nov 20, 2018 via Android
    37
    @balabalaguguji 你就说是不是参考人家的吧
    CyberZCS
    CyberZCS
    Nov 20, 2018
    38
    支持!!!
    icella
    icella
    Nov 20, 2018
    39
    @Kilerd 整个功能还都是抄袭 MinDoc 呢 可是楼主一直不敢正面回答 呵呵
    balabalaguguji
    balabalaguguji
    OP
    Nov 20, 2018
    40
    @icella #39 在你说这个 MinDoc 之前,我们都不知道有这个,我们有参考很多其他同类竞品,你说的这个确实不是我们的追求目标
    icella
    icella
    Nov 20, 2018
    41
    @balabalaguguji 页面排版都一样,这么巧合
    balabalaguguji
    balabalaguguji
    OP
    Nov 20, 2018
    42
    @zifangsky #19 导出离线文档的功能我们会在后面些时间提供
    balabalaguguji
    balabalaguguji
    OP
    Nov 20, 2018
    43
    @lniwn 嗯,现在是收集大家反馈完善阶段,我们不断开发完善
    CEBBCAT
    CEBBCAT
    Nov 21, 2018 via Android
    44
    @Livid #21 说不清,给一下复现步骤:

    1. 打开 /new
    2. 点击分享创造按钮(就是那个链接到 javascript:chooseNode('create') 的)

    这时候发现节点选成了 C/C++/Obj-C/c,复现完毕

    说实话,这是老 bug 了,很老很老。一起想反映的还有节点选单不全的问题。20 号凌晨( CST ),我试着在反馈节点下发帖,被告知发主题帖间隔要大于 10 分钟,从 FAQ 找到 support 那个邮箱之后,心又很累,就没有发邮件

    当然了,若是你或者其他我不知道存在不存在的开发人员没有时间,那可以适当延后,因为最近 V2EX 似乎没有改变

    以上是一个普通用户在凌晨敲下的反馈,可能有点语气低落,抱歉
    以上
    CEBBCAT
    CEBBCAT
    Nov 21, 2018 via Android
    45
    @CEBBCAT Emmm,说好十一点睡觉的,又被室友拖累了 doge
    Livid
    Livid
    MOD
    PRO
    Nov 21, 2018 via iPhone
    46
    @CEBBCAT 谢谢你的描述。初步猜测是节点名里的某个特殊字符导致的问题。我会去看看。目前,V2EX 的代码就是我一个人在写。作为一个两个孩子的父亲,时间确实很紧张。
    balabalaguguji
    balabalaguguji
    OP
    Nov 21, 2018
    47
    @Livid 能否帮我恢复到分享创造那个分类呢,我是想发到那里去的,你这个 bug 导致错位了
    Livid
    Livid
    MOD
    PRO
    Nov 21, 2018
    48
    @balabalaguguji 已经移动。

    在主题最初发布的 10 分钟之内,如果对所在节点不满意,是可以自由移动的。
    xunqin
    xunqin
    Nov 21, 2018
    49
    https://www.kancloud.cn/

    这种网站现在很多了
    hydyy
    hydyy
    Nov 21, 2018
    50
    为啥要造这种轮子
    balabalaguguji
    balabalaguguji
    OP
    Nov 21, 2018
    51
    @xunqin #49 看云我们知道,API 文档你有用过他的写吗?你对比下,我保证你会爱上我们这个,我们这个更加专注 HTTP 文档这些,编写和预览的体验都是超越所有竞品的。当然我们除了对 API 文档支持很好外,对使用手册这种也是支持很好的。
    balabalaguguji
    balabalaguguji
    OP
    Nov 21, 2018
    52
    @hydyy #50 因为市面上没有任何一款产品能达到我们的要求,我们希望编写 API 文档的体验是畅快的,阅读是让人愉悦的。你能找出比我们体验更好的吗?
    devtk
    devtk
    Nov 21, 2018
    53
    请问楼主这个和 readthedoc 有什么区别吗?
    edsheeran
    edsheeran
    Nov 21, 2018
    54
    @kulove abc.xyz 打臉
    wuhai
    wuhai
    Nov 21, 2018
    55
    技术出身的。。不是出生的。。
    univ
    univ
    Nov 21, 2018
    56
    不可以解析 json,很烦
    hydyy
    hydyy
    Nov 21, 2018
    57
    @balabalaguguji 目前用 https://yapi.ymfe.org/ 体验也是极好的
    balabalaguguji
    balabalaguguji
    OP
    Nov 21, 2018
    58
    @sunny2580839896 #56 后面我们会支持
    balabalaguguji
    balabalaguguji
    OP
    Nov 21, 2018
    59
    @kios #53 readthedoc 是直接用 markdown 的,写接口文档特麻烦,你用下就知道了
    nicoljiang
    nicoljiang
    Nov 21, 2018
    60
    支持楼主创造。
    虽然我觉得 yapi 足够优秀漂亮了,而且可以私有化部署。
    balabalaguguji
    balabalaguguji
    OP
    Nov 21, 2018
    61
    @nicoljiang #60 yapi 很多东西还没达到我们的高要求,对比用一下就知道,我们优势大很多
    Eugene1024
    Eugene1024
    Nov 21, 2018
    62
    支持下
    qinxi
    qinxi
    Nov 21, 2018
    63
    居然没有不需要登陆就能演示的 demo 页? 太差评了
    storypanda
    storypanda
    Nov 22, 2018 via Android
    64
    @balabalaguguji 看官网是模仿的 git book ?首页需要好好设计一下
    balabalaguguji
    balabalaguguji
    OP
    Nov 22, 2018
    65
    @qinxi #63 首页底部有 demo
    qinxi
    qinxi
    Nov 22, 2018
    66
    @balabalaguguji #65 我说的演示是全套不用登录的,包括编辑和渲染。。你的 demo 是经过渲染之后的
    balabalaguguji
    balabalaguguji
    OP
    Nov 22, 2018
    67
    @qinxi #66 不登录就编辑的暂时没有,另外登录非常简单了,第三方登录点击一下就进去了。
    levywang
    levywang
    Nov 22, 2018
    68
    你好,非常好用。
    但是手机页面的适配不是很好,图片会溢出整个 body
    balabalaguguji
    balabalaguguji
    OP
    Nov 22, 2018
    69
    @levywang #68 感谢支持,手机上还没做兼容,人手不够,先做好 PC 端,后面会完善手机端
    aqqwiyth
    aqqwiyth
    Nov 22, 2018
    70
    接口测试在哪呢..
    univ
    univ
    Nov 22, 2018
    71
    @balabalaguguji 那就太好了
    balabalaguguji
    balabalaguguji
    OP
    Nov 22, 2018
    72
    @aqqwiyth #70 HTTP 文档编辑页面和预览页面都有
    M0
    M0
    Nov 22, 2018
    73
    bug 反馈: 点击 A 文档后,向下滚动,页面停留在 x 位置,点击 B 文档,希望此时页面跳转到 B 文档的头部,但是页面会显示 B 文档的 x 位置。
    balabalaguguji
    balabalaguguji
    OP
    Nov 23, 2018
    74
    @M0 #73 收到,最近我们会修复
    balabalaguguji
    balabalaguguji
    OP
    Nov 23, 2018
    75
    @M0 #73 已修复
    SingeeKing
    SingeeKing
    Nov 26, 2018
    76
    做得很好,希望什么时候有开源自部署了可以 At 一下我
    balabalaguguji
    balabalaguguji
    OP
    Nov 27, 2018
    77
    @SingeeKing #76 好的
    About   ·   Help   ·   Advertise   ·   Blog   ·   API   ·   FAQ   ·   Privacy   ·   Solana   ·   1677 Online   Highest 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 181ms · UTC 04:23 · PVG 12:23 · LAX 20:23 · JFK 23:23
    ♥ Do have faith in what you're doing.