# 参与社区

欢迎来到Sermant！本文档是关于如何为 Sermant 做出贡献的指南。

如果您发现不正确或遗漏的内容，请留下意见/建议

# 开始之前

# 行为守则

请务必阅读并遵守我们的行为准则 (opens new window)。

# 开源贡献协议

Sermant社区采用DCO (Developer Certificate of Origin (opens new window)) 作为开源贡献协议，如果您想参与社区贡献，需要按照以下步骤进行。

# 注册GitHub账号

如果您没有GitHub账号，需要登录GitHub并使用电子邮件地址进行注册。电子邮件地址用于对DCO进行签名并配置SSH公钥。

# 签署DCO

DCO (Developer Certificate of Origin (opens new window))是一种轻量级的开源贡献协议，供开源贡献者证明他们有权授予项目使用他们的代码。

使用Git CLI提交代码commit时，可以使用-s参数 (opens new window)添加签名。使用示例如下：

$ git commit -s -m 'This is my commit message'

签名会作为被提交commit信息的一部分，格式为：

This is my commit message

Signed-off-by: Full Name <email>

• 如果您使用IntelliJ IDEA提交代码，可以在Commit Change工具框中勾选Sign-off commit选项，即可在每次提交时附上签名信息。具体操作请参考IntelliJ IDEA 使用文档 (opens new window)。
• 如果您使用Visual Studio Code提交代码，可以在Settings中勾选Git: Always Sign Off选项，即可在每次提交时附上签名信息。具体操作请参考Visual Studio Code相关说明 (opens new window)。

请确认每次提交commit时都正确按照以上方式添加签名签署DCO，否则您提交的代码将不会被接纳合入至我们的开源仓库。

# 贡献

Sermant 欢迎任何角色的新参与者，包括用户、贡献者、提交者和 PMC。

我们鼓励新人积极加入 Sermant 项目，从用户角色到提交者角色，甚至 PMC 角色。为了做到这一点，新人需要积极参与 Sermant 项目。以下段落介绍如何以 Sermant 方式进行贡献。

# 打开/提取Issue以进行准备

如果你发现文档中的错字，发现代码中的错误，或者想要新功能，或者想要提出建议，你可以在 GitHub (opens new window) 上提Issue。

如果您只想直接贡献，您可以选择下面的Issue:

• Contribution Welcome (opens new window): 急需的问题，但目前手头不足。

• good first issue (opens new window): 适合新人，新人可以拿一个热身。

我们非常重视文档和与其他项目的集成，例如 Spring Cloud、Kubernetes、Dubbo 等。我们很高兴在这些方面解决任何问题。

请注意，任何 PR 都必须与有效问题相关联。否则 PR 将被拒绝。

# 开始你的贡献

现在，如果您想贡献，请创建一个新的拉取请求。

我们使用develop分支作为开发分支，说明这是一个不稳定的分支。

此外，我们的分支模型符合 一个成功的 Git (opens new window) 分支模型。我们强烈建议新人在创建 PR 之前先阅读上述文章。

现在，如果您准备好创建 PR，以下是贡献者的工作流程：

1. Fork to your own

2. Clone fork to local repository

3. Create a new branch and work on it

4. Keep your branch in sync

5. Commit your changes (make sure your commit message concise)

6. Push your commits to your forked repository

7. Create a pull request to develop branch.

创建拉取请求时:

1. Please follow the pull request template (opens new window).

2. Please create the request to develop branch.

3. Please make sure the PR has a corresponding issue.

4. If your PR contains large changes, e.g. component refactor or new components, please write detailed documents about its design and usage.

5. Note that a single PR should not be too large. If heavy changes are required, it's better to separate the changes to a few individual PRs.

6. After creating a PR, one or more reviewers will be assigned to the pull request.

7. Before merging a PR, squash any fix review feedback, typo, merged, and rebased sorts of commits. The final commit message should be clear and concise.

如果您的 PR 包含较大的更改，例如组件重构或新组件，请写详细的设计和使用文档。

# 代码审查指南

提交者将轮流审查代码，以确保在合并前至少由一名提交者及时审查所有 PR。如果我们不做我们的工作（有时我们会丢东西）。和往常一样，我们欢迎志愿者进行代码审查。

一些原则:

• Readability - 重要的代码应该有据可查。 API 应该有 Javadoc。代码风格应与现有风格保持一致。

• Elegance - 新的函数、类或组件应该设计得很好。

• Testability - 单元测试用例应该覆盖 80% 的新代码。

• Maintainability - 代码可维护性好.

# 现在如何尝试成为commiter?

一般来说，贡献 8 个重要的补丁并让至少三个不同的人来审查它们（你需要三个人来支持你）。然后请人提名你。你在展示你的:

• at least 8 PR and the associated issues to the project,

• ability to collaborate with the team,

• understanding of the projects' code base and coding style, and

• ability to write good code (last but certainly not least)

当前的提交者通过在 Sermant Issue上用标签提名你

• your first and last name

• a link to your Git profile

• an explanation of why you should be a committer,

• Elaborate the top 3 PR and the associated issues the nominator has worked with you that can demonstrate your ability.

另外两个提交者需要支持你的提名。如果 5 个工作日内没有人反对（中国），您就是提交者。如果有人反对或想要更多信息，提交者会讨论并通常达成共识（在 5 个工作日内）。如果问题无法解决，则在当前提交者之间进行投票。

在最坏的情况下，这可能会拖延两周。继续贡献！即使在极少数提名失败的情况下，反对意见通常也很容易解决，例如“更多补丁”或“没有足够多的人熟悉此人的工作”。