Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

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

Open
kvkens opened this issue May 13, 2018 · 1 comment
Open

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

kvkens opened this issue May 13, 2018 · 1 comment

Comments

@kvkens
Copy link
Member

kvkens commented May 13, 2018

按照我们目前的官网示例系统来看,还不是很好,主要是方便性,比如说,我在使用的过程中,打开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工具去使用,但是最后被组件弄的精疲力尽,实际上这次出差不少问题是我们没有在网站说清楚,很多都是凭着经验去解决。

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

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

@kvkens
Copy link
Member Author

kvkens commented May 13, 2018

大家都可以来说说,可以列个TODO,这只是文档上的,组件上的我找时间反馈~

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

10 participants