我们很高兴您有兴趣为 Semi UI 做出贡献。 在提交您的贡献之前,请务必花点时间阅读以下指南:
- main: 通常情况下该分支仅作为最新稳定版本代码的快照,用于发布正式版本。每双周会合并
beta
到此分支发布一个minor版本。如果修复了紧急bug,我们会基于此分支修复并发布patch版本 - beta: 用于bug修复和feature开发。发布minor版本后的一周会基于此分支发布beta版本
我们使用 Github issues 来追踪 bug。为了更快地了解和解决bug,在提交issue时,你也可以通过我们提供的模板来重现问题。
如果你有提供或者优化功能的想法,我们推荐你使用Github issues来新建一个添加新功能的issue。
Semi Design团队会认真对待每一个Pull Request。我们会review并合并你的代码。也有可能对你的代码提出一些修改意见。
要提交一个Pull Request,请遵循以下步骤:
- Fork 项目并克隆下来
git clone https://github.com/<your-username>/semi-design.git
cd semi-design
- 切换到
beta
分支,完成项目依赖安装
git checkout beta
npm run bootstrap
- 接下来进行你想要做的修改,可以是bug修复,也可以是新功能的开发
- 你可以通过运行storybook(
npm start
)和官网(npm run docsite
)来验证逻辑 - 为你的修改编写测试用例,并确保测试通过
npm run test:unit
- 新建一个Pull Request到源项目的
beta
分支
文档站基于 gatsby 构建,核心代码在 src
目录。
组件文档位于 semi-ui
组件文件夹下的 md 文件。 以 tooltip 为例:
- 中文文档
packages/semi-ui/tooltip/index.md
- 英文文档
packages/semi-ui/tooltip/index-en-US.md
启动文档站点
npm run docsite
如果您有兴趣帮助我们提高文档的质量,请修改对应组件的md文件,按照Pull Request指南提交您的改动