Skip to content

对于这次出差使用文档的一些建议反馈 #5

Description

@kvkens

按照我们目前的官网示例系统来看,还不是很好,主要是方便性,比如说,我在使用的过程中,打开http://bee.tinper.org/bee-table/ 表格组件文档,网速慢的话,会发现demo没有加载,这个我是能理解的,等一下就可以一个个蹦出来。但是我想看下实现的表格里面都有哪些示例.

  1. 比如像antd那样的副标题,给我一些传送门的体验那样比较好,对于项目上的前端有的水平忽高忽低,他们必须有这种的方便的体验,要不然看都不愿意看,就会直接去群里去说这个组件没有吧啦吧啦的。

image

  1. 再就是我们的代码复制系统,严重缺失体验,复制的不属于代码的一些空格,错位,在VSCODE里都无法格式化的那种,这点参考antd的代码系统。还有相应的锚点链接。我想一键复制代码都不能.

image

  1. 要增加codepen 这类的代码真实示例系统,一个链接过去,用户自己看一下具体怎么实现的,可以在线去修改去运行,这样动手的能力也有了。

image

  1. 优化我们的代码,我们作为大前端为别人提供代码的时候,一定要讲究代码风格,对于分公司这类的前端都不是专业的前端,复制的代码会一直那样去复制去做,不会讲究代码风格,可能一个无状态组件会一直那么用。

  2. 文档API有个别的错误,比如table的api,里面有的markdown都写错了,需要自查,不然太让人笑话了。

image
image
image
image

  1. 文档的样式是否找专业的UI UE去重新设计,目前的太丑了,在外面听到过这样的评价。

  2. 我们目前的demo实现的一些功能代码,有点反人类,就拿table来说,我要实现表格checkbox选中这样的功能,我发现我要自己去实现很多代码,一顿复制粘贴,把太多的状态暴露在外面了,这样对于小白来说简直是灾难,我之前组件用的少,直到今天,我发现我竟然不会用,但是我看antd的那种实现,就很简单,举个例子:

const rowSelection = {
  onChange: (selectedRowKeys, selectedRows) => {
    console.log(`selectedRowKeys: ${selectedRowKeys}`, 'selectedRows: ', selectedRows);
  },
  getCheckboxProps: record => ({
    disabled: record.name === 'Disabled User', // Column configuration not to be checked
    name: record.name,
  }),
};

ReactDOM.render(
  <Table rowSelection={rowSelection} columns={columns} dataSource={data} />
, mountNode);

https://ant.design/components/table-cn/#components-table-demo-row-selection-and-operation

上面是antd实现的选中,非常容易我就实现了

再看一下我们的:
https://github.com/tinper-bee/bee-table/blob/master/demo/demolist/Demo12.js

简直是灾难!!!关键是,我点击了例子,发现console里并没有什么输出,我都不知道数据哪来?
来看我们看看antd的选择:
image

对于这边的用户来讲,用咱们的组件,就是图个快速开发,配合tinper-devtool工具去使用,但是最后被组件弄的精疲力尽,实际上这次出差不少问题是我们没有在网站说清楚,很多都是凭着经验去解决。

通过到开发现场去,才会知道开发的水平,不能按照我们的技术水平去要求他们,这是值得我们注意的,也就是说我们的东西越简单越能接地气,不然那么高深牛逼的东西,对于小白前端来说,不知所云啊~~~

几点建议,莫怪,为了我们好,良药苦口~😆

Metadata

Metadata

Labels

No labels
No labels

Type

No type

Fields

No fields configured for issues without a type.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions