快速贡献¶
MatrixOne 社区欢迎所有开发者的加入和贡献!本章节旨在帮助您快速完成首次贡献。
如何贡献?¶
在哪些方面可以大展拳脚呢?详情请参见贡献种类。 如果您是完全的新手,您可以从以下两种类别中选择一种进行尝试,这些类别的问题对您技术背景的要求很少,所以不必担心!
报告代码中出现的 Bug
完善 MatrixOne 文档
在开始处理问题之前,建议您先将找到的问题作为 GitHub 上的一项 Issue 提出。此外,我们准备了一系列带有 good-first-issue 标签的 Issue,它们包含了明晰的实现步骤和预期结果,您可以此作为突破口!
认领任务¶
当您提出 Issue 之后或者是在浏览 good-first-issue 后决定上手解决,您需要认领这次 Issue。在相应 Issue 的评论中输入如“I’d like to work on this issue”,社区人员会将任务分配给您,此时,您可以在右侧的 Assignees 板块看见自己,接下来便可以正式着手解决问题。
前置准备¶
请确保您至少安装了单机版 MatrixOne 并部署了相关开发环境。具体请参考准备工作。
工作流程¶
步骤 1:Fork 项目仓库¶
首先前往 Github 上的 matrixorigin/matrixone 仓库。
在页面右上角处,点击 Fork 按键,创建主库的分叉,并作为您之后主要工作的仓库。
步骤 2:将仓库克隆至本地¶
前往刚才您创建的 Fork 仓库,点击 Code,然后再点击复制图标,将库的网址复制到剪贴板。
然后,在您本地挑选一个合适的工作目录,打开命令行输入以下 Git 命令将文件克隆至您本地的目录:
git clone <content you just copied>
例如:
git clone git@github.com:<yourname>/matrixone.git
<yourname> 是您的 Github 账号名,换言之,您要用您自己的账号名替换它。
步骤 3:添加 matrixone 仓库作为本地的远程仓库¶
您可以将 matrixorigin/matrixone 添加为本地的远程仓库,以便后续步骤进行操作:
git remote add upstream https://github.com/matrixorigin/matrixone.git
其中,upstream 是该远程仓库的名字,您可以自行替换,但注意后续对该词也应该一并替换。
步骤 4:修改、试运行¶
修改¶
先创建工作分支,再针对 Issue 修改代码。文档修改应提交到独立的 matrixone-doc 仓库;详见文档贡献指南。
试运行¶
如果您在修改完成后想知道改动是否有效,能否解决最初的问题,或者是否影响程序运行,您可以运行 MatrixOne 进行简单的预览和测试。 当然,请确保您已经按照教程完成了单机部署 MatrixOne。
步骤 5:提交修改¶
当完成以上修改和测试后,您就可以开始提交修改。首先使用将您所更改的文件添加至 git 所管理的目录中:
git add <filename>
<filename> 是您所修改的文件的名称。
您也可以使用如下命令,直接将当前文件夹中的所有文件都添加至管理目录:
git add .
之后,您可以提交您的修改
git commit -m "<commit message>" -s
<commit message> 是您对本次修改的简单总结和描述,试着做到简明扼要。
步骤 6:代码推送¶
提交修改后,您需要将本地的提交推送至远程仓库———我们强烈推荐您推送至目标仓库的一个新分支:
git push -u origin topic-branch
topic-branch 是您的工作分支名,可替换为实际名称。
步骤 7:创建 PR¶
推送后,点击 Compare & Pull Request 创建 PR;源分支为个人仓库的 topic-branch,目标是对应的上游分支。
备注
注意 建议按照 PR 中所给出的模板要求,撰写相关信息,如此可以准确表达您的问题以及所做的修改,从而提高审查效率。

您的 PR 一旦创建,就有社区资深的开发人员审核您的代码,他将会检查您做的修改并且进行回复,请及时与您沟通,然后按照要求进行修改。
步骤 8:同步代码库¶
PR 合并后,先获取上游更新并检查提交历史,再更新本地和 fork 的 main。工作分支在不再需要前应予以保留;不要强推覆盖 main。