V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
V2EX 提问指南
4771314
V2EX  ›  问与答

一个中间件或者组件到底要怎样才能让使用者满意并且易上手?

  •  
  •   4771314 · 2020-11-19 10:30:19 +08:00 · 1161 次点击
    这是一个创建于 1498 天前的主题,其中的信息可能已经有所发展或是发生改变。

    目前在做一些 Node 公共组件和中间件的事情,总是遇到奇葩的问题 1 、一个内部用的 httpclient 组件,用户使用的时候需要自己设置 header,使用者在设置的时候 header 拼写错了,说是我们提供的组件太复杂了,还需要手动传入 header 的全称,让我们提供 set 方法,降低使用门槛。 2 、一个函数,需要用户指定输入的 type,已经用 ts 的 type 定义了,用户使用的时候有提示,还是门槛太高了,说是都不知道输入啥?让提供 type 的结构体定义(其实函数签名中已经说明了取值范围)。 3 、一个函数没有提供使用示例,反馈说不知道怎么用???函数是有注释的,参数也在注释中说明了,结果是用户根本就么有看函数签名,就是说不会用?? 。。。。

    这样的问题还有很多,反正就是很奇葩,我感觉自己太难了,想想自己刚写 JS 的时候,全是 any,都不知道自己是怎么过来的了。

    觉得公司的实习是真的奇葩,我们组有一个都来了快一个月了,每天的日报还是学习了 xxx,熟悉了 xxx,真就学习呗?实习是不是就是学习,我不清楚,之前的公司的实习生基本都是 1 ~ 2 周后就开始进项目了,这边的感觉 2 月能进项目就不错了。

    5 条回复    2020-11-19 15:21:28 +08:00
    wysnylc
        1
    wysnylc  
       2020-11-19 10:42:30 +08:00
    把自己当白痴去使用和测试
    kop1989
        2
    kop1989  
       2020-11-19 10:46:41 +08:00
    做公共组件最起码得有说明+例子。好一点的还要有 web 上的实时编译 demo,方便使用者快速体验组件的功能、可配置性、可扩展性是否符合自己的需求。

    中间件、库的精髓就是让使用者思考越少越好。
    w292614191
        3
    w292614191  
       2020-11-19 11:42:02 +08:00   ❤️ 2
    楼主你这个问题也不排版,也不分段落,也不列表说明问题。

    由此看出,你做的中间件真的很难用。
    cnoder
        4
    cnoder  
       2020-11-19 11:53:12 +08:00
    进不进项目不是看人怎么带吗,天天一点小工作也不分配,人家不学点东西干什么
    4771314
        5
    4771314  
    OP
       2020-11-19 15:21:28 +08:00
    @cnoder 是啊,我觉得,熟悉下环境,讲下规范,直接上手简单得项目或者需求,看日报一直是在学习这,学习那得,我都替他憋屈
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   3941 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 23ms · UTC 10:17 · PVG 18:17 · LAX 02:17 · JFK 05:17
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.