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

[4771314]

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

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

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

[wysnylc]

把自己当白痴去使用和测试

[kop1989]

做公共组件最起码得有说明+例子。好一点的还要有 web 上的实时编译 demo，方便使用者快速体验组件的功能、可配置性、可扩展性是否符合自己的需求。

中间件、库的精髓就是让使用者思考越少越好。

[w292614191]

楼主你这个问题也不排版，也不分段落，也不列表说明问题。

由此看出，你做的中间件真的很难用。

[cnoder]

进不进项目不是看人怎么带吗，天天一点小工作也不分配，人家不学点东西干什么

[4771314]

@cnoder 是啊，我觉得，熟悉下环境，讲下规范，直接上手简单得项目或者需求，看日报一直是在学习这，学习那得，我都替他憋屈