Skip to content

Commit 2d8093d

Browse files
authored
docs: add doc CONTRIBUTING.md (#45)
1 parent 6249ce5 commit 2d8093d

File tree

3 files changed

+50
-3
lines changed

3 files changed

+50
-3
lines changed

CONTRIBUTING.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
packages/devui-vue/docs/CONTRIBUTING.md
Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,8 @@
11
const nav = [
22
{ text: '组件', link: '/' },
3-
{ text: '版本历程', link: 'https://github.com/DevCloudFE/vue-devui/releases' },
4-
{ text: '设计规范', link: 'https://devui.design/design-cn/start' },
3+
{ text: '贡献指南', link: '/CONTRIBUTING' },
4+
{ text: '更新日志', link: 'https://github.com/DevCloudFE/vue-devui/releases' },
5+
{ text: '设计规范', link: 'https://devui.design/design-cn/start' }
56
]
67

7-
export default nav
8+
export default nav
Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,45 @@
1+
# Vue Devui 贡献指南
2+
3+
你好! 我们很高兴你有兴趣为 Vue Devui 做出贡献。 在提交你的贡献之前,请务必花点时间阅读以下指南:
4+
5+
## 快速上手
6+
7+
Vue Devui 使用 `lerna.json` + `yarn` 构建 `monorepo` 仓库,你应该使用 [yarn](https://yarn.bootcss.com/) 包管理器,以确保不会因为包管理器的不同而引发异常
8+
如果你想参与 `devui-vue` 的开发或者测试:
9+
10+
1. 点击Github右上角的Fork按钮,将仓库Fork仓库到个人空间
11+
2. Clone个人空间项目到本地:`git clone [email protected]:username/vue-devui.git`
12+
3. 在 Vue Devui 的根目录下运行`yarn i`, 安装node依赖
13+
4. 进入 `packages/devui-vue` 目录下,运行 `yarn run dev`,这个脚本将会启动 `vitepress` 和组件库的开发环境下构建
14+
5. 使用浏览器访问:http://localhost:3000(如遇白屏,请手动刷新页面)
15+
16+
```bash
17+
# username 为用户名,执行前请替换
18+
git clone [email protected]:username/vue-devui.git
19+
cd vue-devui
20+
git remote add upstream [email protected]:DevCloudFE/vue-devui.git
21+
yarn i
22+
yarn run dev
23+
# 或者(推荐)
24+
cd packages/devui-vue && yarn run dev
25+
```
26+
27+
## 参与贡献
28+
29+
Vue Devui 是一个多人合作的开源项目,为了避免多人同时开发同一个组件/功能,请先在 [issues 列表](https://github.com/DevCloudFE/vue-devui/issues) 中选择自己感兴趣的任务,在评论区认领
30+
31+
1. 请确保你已经完成快速上手中的步骤,并且正常访问 http://localhost:3000
32+
2. 创建新分支 `git checkout -b username/feature1`,分支名字建议为`username/feat-xxx`/`username/fix-xxx`
33+
3. 本地编码
34+
4. 遵循 [Angular Commit Message Format](https://github.com/angular/angular/blob/master/CONTRIBUTING.md#commit) 进行提交(**不符合规范的提交将不会被合并到dev分支**
35+
5. 提交到远程仓库,也就是Fork 后的仓库,`git push origin branchName`
36+
6. (可选) 同步上游仓库dev分支最新代码,`git pull upstream dev`
37+
7. 打开上游仓库提交[PR](https://github.com/DevCloudFE/vue-devui/pulls)
38+
> 如果涉及新组件或组件的新特性,则需要:
39+
9. 完善组件中英文文档
40+
10. 完善组件的单元测试
41+
11. 完成组件[自检清单](https://github.com/DevCloudFE/vue-devui/wiki/%E7%BB%84%E4%BB%B6%E8%87%AA%E6%A3%80%E6%B8%85%E5%8D%95)
42+
12. 仓库管理员进行Code Review,并提出意见
43+
13. PR 发起人根据意见调整代码(一个分支发起了PR后,后续的commit会自动同步,不需要重新PR)
44+
14. 仓库管理员合并PR
45+
15. 贡献流程结束,感谢你的贡献

0 commit comments

Comments
 (0)