跳到主要内容

贡献

感谢你对 Apache Answer 的关注，希望本文档能让你对贡献过程有更清楚的了解。

我们推荐你访问 开源指南网站，该网站为个人、社区和公司提供了开源相关的学习、运营和贡献等资源。无论是经验丰富的贡献者，还是刚接触开源的新手，都能从下面的文档里找到有益的指引：

行为准则​

Apache Answer 通过了一项行为准则，我们希望项目参与者遵守该准则。请阅读全文，以便你了解哪些行动是可以接受的，哪些是不可以的。

参与进来​

Apache Answer 是一个由热情的用户、贡献者和PMC成员共同打造的开源项目。我们致力于创建一个开放和包容的社区，我们欢迎每个人加入我们，遵循 Apache 之道，携手构建开源生态。

任何人都可以为 Apache Answer 做出贡献。不局限于贡献代码，以下是其他的参与方式：

使用 Apache Answer​
  • 运行 Apache Answer 很容易。只需遵循我们的入门指南，看看是否一切按预期运行。
  • 如果遇到问题，你可以创建一个问题来报告错误或提出改进建议。
参与处理问题和代码提交请求​
  • 如果你认为问题没有提供解决它所需的所有细节，请询问用户提供更多信息。
  • 帮助问题添加标签有助于对问题进行分类。
  • 标记过时或应该关闭的问题。
  • 询问测试计划和审查代码。
贡献代码​
  • 如果你找到你可以解决的问题，请认领它。创建一个拉取请求来提交你的更改。
  • 标记为good first issue的问题非常适合新手们。
改进文档​
  • 如果你在阅读我们的文档时发现任何错别字、语法或内容错误，只需单击“编辑此页面”并直接在 GitHub 上进行编辑即可。
开发插件​
  • 通过开发插件，延展 Apache Answer 的功能。
  • 可以查看现有插件需求，或者开发和提交实现他人或者自己需要的那个功能。
参与版本发布​
  • 通过测试新的候选版本并参与 dev@answer.apache.org 上投票。
  • 如果你没有发现任何问题，可以投+1 (non-binding)赞成票。
  • 如果你发现了问题，可以投 -1 (non-binding)反对票。
贡献翻译​
  • 如果你还掌握英语以外的语言，你可以使用 Crowdin 帮助我们将 Apache Answer 翻译成其他语言。
  • 关于其他信息，请阅读贡献翻译指南。
提供支持​
推广 Apache Answer​
  • 在社交媒体上分享 Apache Answer 。
  • 把你的使用心得分享给更多人。
  • 参与我们的闲暇聚会、论坛等活动。
其他​
  • 有新想法吗？我们非常欢迎任何形式的贡献。
  • 如果你在规划贡献时遇到问题，请联系我们，并告诉我们你需要一些帮助。

开发过程​

Apache Answer 使用GitHub作为代码版本库。核心团队将在该平台进行协作开发。所有的代码变更都是对外公开的。

所有 Pull Request 都将由持续集成系统（GitHub Actions）进行检查，其中包括单元测试等其它测试方法。

分支管理​

提交PR时应选择哪个分支？

  • main分支对应于最新版本的 Answer。如果你正在为最新版本修复问题，请选择主分支。
  • dev分支用于下一个版本的开发。因此，如果你正在开发新功能，请切换到开发分支，并为其提交PR。

通常，我们在问题上标记里程碑 (milestone) 来跟踪问题应该在哪个版本中修复。因此，你可以根据里程碑确定应将代码提交到哪个分支。