Skip to content

Latest commit

 

History

History
144 lines (100 loc) · 6.59 KB

CONTRIBUTING.zh-CN.md

File metadata and controls

144 lines (100 loc) · 6.59 KB
Raw

贡献指南

很高兴你有意愿参与 OpenTiny HUICharts 开源项目的贡献，参与贡献的形式有很多种，你可以根据自己的特长和兴趣选择其中的一个或多个：

  • 报告新缺陷
  • 为已有缺陷提供更详细的信息，比如补充截图、提供更详细的复现步骤、提供最小可复现 demo 链接等
  • 提交 Pull requests 修复文档中的错别字或让文档更清晰和完善
  • 添加官方小助手微信 opentiny-official，加入技术交流群参与讨论

当你亲自使用 OpenTiny HUICharts 组件库，并参与多次以上形式的贡献，对 OpenTiny HUICharts 逐渐熟悉之后，可以尝试做一些更有挑战的事情，比如：

  • 修复缺陷，可以先从 Good-first issue 开始
  • 实现新特性
  • 完善单元测试
  • 翻译文档
  • 参与代码检视

提交 Issue

如果你在使用 OpenTiny HUICharts 组件过程中遇到问题，欢迎给我们提交 Issue，提交 Issue 之前，请先仔细阅读相关的官方文档，确认这是一个缺陷还是尚未实现的功能。

如果是一个缺陷，创建新 Issue 时选择 Bug report 模板，标题遵循 [componentName]缺陷简述 的格式，比如：[PieChart]在单击圆盘图的扇形区域时，无法依次选中多个扇形。

报告缺陷的 Issue 主要需要填写以下信息：

  • tiny-charts 的版本号
  • 缺陷的表现，可截图辅助说明，如果有报错可贴上报错信息
  • 缺陷的复现步骤，最好能提供一个最小可复现 demo 链接

如果是一个新特性，则选择 Feature request 模板，标题遵循 [componentName]新特性简述 的格式，比如：[PieChart]圆盘图存在非常小的数据时占比面积几乎为0，影响视觉，希望增加最小角度的设置。

新特性的 Issue 主要需要填写以下信息：

  • 该特性主要解决用户的什么问题
  • 该特性的 api 是什么样的

提交 PR

提交 PR 之前，请先确保你提交的内容是符合 OpenTiny HUICharts 整体规划的，一般已经标记为 bug 的 Issue 是鼓励提交 PR 的，如果你不是很确定，可以创建一个 Discussion 进行讨论。

Pull Request 规范

Commit 信息

commit 信息要以 type(scope): 描述信息 的形式填写，例如 fix(LineChart): fix xxx bug。

  1. type: 必须是 build, chore, ci, docs, feat, fix, perf, refactor, revert, release, style, test, improvement 其中的一个。
  • feat: 增加新功能
  • fix: 修复问题
  • docs: 修改文档
  • style: 修改代码格式，不改变代码逻辑
  • refactor: 重构代码，不影响现有功能
  • perf: 提升性能
  • test: 添加或修改测试用例
  1. scope:
  • 组件的名称(大驼峰): 比如: LineChart, BarChart, FlowChart

Pull Request 的标题

  1. 标题的规范与 commit 信息一样，以type(scope): 描述信息 的形式填写。
  2. 标题示例:
  • 给 LineChart 组件增加新特性： feat(LineChart): xxxxxxxxxxxxxxx
  • 修复 LineChart 组件 @opentiny/huicharts 下的缺陷: fix(LineChart): xxxxxxxxxxxxxx
  • 补充 LineChart 组件文档： docs(LineChart): xxxxxxxxxxxxxxx
  • 补充 LineChart 组件测试用例: test(LineChart): xxxxxxxxxxxxxx

Pull Request 的描述

PR 描述使用了模板，需要按照模板填写 PR 相关信息，主要包括：

  • PR 自检项：Commit 信息是够符合规范、是否补充了 E2E 测试用例、是否补充了文档
  • PR 类型：缺陷修复、新特性、代码格式调整、重构等
  • 关联的 Issue 编号
  • 是否包含破坏性变更

本地启动步骤

  • 点击 OpenTiny HUICharts 代码仓库右上角的 Fork 按钮，将上游仓库 Fork 到个人仓库
  • Clone 个人仓库到本地
  • 关联上游仓库，方便同步上游仓库最新代码
  • 在 OpenTiny HUICharts 根目录下运行 npm i, 安装 node 依赖
  • 运行 npm run dev，启动组件库网站
  • 打开浏览器访问：http://localhost:8080/
# username 为用户名，执行前请替换
git clone [email protected]:username/tiny-charts.git
cd tiny-charts

# 关联上游仓库
git remote add upstream [email protected]:opentiny/tiny-charts.git

# 安装依赖
npm i

# 启动 charts 项目
npm run dev

提交 PR 的步骤

  • 请确保你已经完成本地启动中的步骤，并能正常访问：http://localhost:8080/
  • 保证当前为dev分支，同步上游仓库 dev 分支最新代码：git pull upstream dev
  • 从 dev 分支创建新分支 git checkout -b branchName，分支名称建议为 username/feat-xxx / username/fix-xxx，若是在fork下来的仓库开发，分支名称无需添加username，直接feat-xxx。
  • 本地编码
  • 将本地变更代码提交到远程仓库，遵循 Commit Message Format 规范进行提交，不符合提交规范的 PR 将不会被合并。
# 暂存变更
git add .

# 查看暂存的变更
git status

# 提交变更
git commit -m 'feat(LineChart): xxx'

# 变更提交到远程仓库
git push origin branchName
  • 打开 OpenTiny HUICharts 代码仓库的 Pull requests 链接，点击 New pull request 按钮提交 PR
  • 按照 PR 模板补充相关信息，包括 PR 自检项、PR 类型、关联的 Issue 编号、是否是破坏性变更
  • 项目 Committer 进行 Code Review，并提出意见
  • PR 作者根据意见调整代码，请注意一个分支发起了 PR 后，后续的 commit 会自动同步，无需重新提交 PR
  • 项目管理员合并 PR

贡献流程结束，感谢你的贡献！

加入开源社区

如果你对我们的开源项目感兴趣，欢迎通过以下方式加入我们的开源社区。

  • 添加官方小助手微信：opentiny-official，加入我们的技术交流群
  • 加入邮件列表：[email protected]

如果你给 OpenTiny 提交过 Issue 或 PR，请通过以下方式添加自己到贡献者列表里。

@all-contributors please add @<username> for <contributions>

详细规则可以参考：https://allcontributors.org/docs/en/bot/usage