Skip to content

贡献规则

luxiang zhou edited this page Feb 25, 2021 · 1 revision

贡献规则

非常感谢您的贡献,各种贡献都值得鼓励和重视!💖

在做出贡献之前,请务必阅读相关部分,这将使项目的维护更加顺畅。📝

目录

交流反馈

需要支持

如果您有疑问,需要支持或讨论,请按照以下步骤操作:

  • Discussions创建新的议题并正确归类。
  • 在新建之前,请搜索是否已有重复的议题,如果重复,请在原议题中寻求答案或继续讨论。
  • 如果是遇到问题,请尽可能详尽地描述您的使用环境以及出问题的上下文操作。

项目成员将尽快给与答复。

报告异常

如果您在使用过程中遇到异常,请按照以下步骤操作:

  • Discussions搜索是否有相关异常的议题与答案。
  • Issue搜索是否有相关待办项正在进行中。
  • 如果异常非常明显,在Issue新建用于建报告异常的issue并尽可能详尽地描述如何引发异常。
  • 如果异常不容易复现,则在Discussions创建discussion并描述异常以及平台环境与上下文操作。

项目成员会尽快确认异常,如果成功定位异常,与此异常相关的修复将合并至主分支,同时此issue将被关闭。

如果您有意愿为工程提交异常修复,请遵循开发规范

新增功能

如果项目缺少您需要的功能,请按照以下步骤操作:

  • Discussions搜索是否有相关功能的议题与答案。
  • Issue搜索是否有相关待办项正在进行中。
  • 如果没有结果,在Issue新建用于新增功能的issue并尽可能详尽地描述功能需求,并解释为什么现有功能和替代方法对您不起作用。

项目成员会尽快评估功能请求,并给issue添加对应label。

注意:项目成员不太可能接受每个提交的功能请求,如果拒绝请多理解。

被接受的issue会更新对应的label状态,如果确定开发者则会被标记开发中,长时间未确定开发者的issue会被标记请求帮助

如果您有意愿为工程提交新增功能,请遵循开发规范

开发规范

贡献代码除了要遵循Pull Requests流程,还需遵循以下规范。

分支合并

工程默认包括以下分支:

  • main 主分支

    • 最新的发行版工程
    • 禁止对该分支直接提交
    • 必须在可以发行时由develop签出的release分支merge更新
  • develop 开发分支

    • 最新的集成各开发任务的工程
    • 禁止对该分支直接提交
    • 新特性的开发从develop分支签出
    • 新特性开发完成后对develop分支提交合并请求
  • release 发行分支

    • 用于从develop签出到master的分支
    • 禁止对该分支直接提交
    • 随着发行流程创建与删除
    • 期间只能合并错误修复,不可加入新增特性

新特性的开发与提交请针对develop分支,并且合并到develop分支。

代码风格

工程使用vscode+rust-lang.rust插件开发并格式化代码,为保证代码风格连贯,使用其他工具提交前请使用rustfmt进行排版。具体的代码格式可以参考Rust Style Guide

提交信息

代码提交信息遵循Angular Commit Message Format。 使用vscode可以安装redjue.git-commit-plugin插件自动填写提交信息。

代码审核

创建Pull Requests后,将由项目成员审核,通过后将merge到对应分支。如果存在问题,项目成员将在Pull Requests中描述问题原因并等待修改完成或关闭该Pull Requests