贡献#
本文档是贡献代码库的权威指南。我们欢迎您对项目进行修补和贡献,并感谢您的支持。
为确保流程顺畅,请遵循一些简单的指南。
开始#
请务必阅读并遵守我们的行为准则。
进行您的首次贡献#
从何开始#
我们随时欢迎帮助!例如,文档总是可以改进的。总有代码可以阐明,变量或函数可以重命名或注释。总是需要更多的测试覆盖。您明白了——如果您发现任何您认为应该修复的东西,您就应该负责。以下是您入门的方法。
良好开端问题#
查找 AIBrix 中适合作为切入点的问题
加入社区#
如果您想,请遵循这些说明
成为 AIBrix GitHub 组织的官方成员#
在请求加入 AIBrix GitHub 组织之前,我们恳请您进行一些初步贡献,以表明您将继续为 AIBrix 做出贡献的意图。
有多种方式可以为 AIBrix 做出贡献
提交 PR(代码或文档)
提交报告错误或提供反馈的问题
在 Slack 或 GitHub 问题中回答问题
当您准备好加入时,请提交一个问题,请求将自己添加为该问题中的成员。
PR 流程#
丰富您的 PR 信息#
提供清晰的描述:确保您的 PR 包含一个简洁但信息丰富的描述。总结所解决的问题、所采取的方法以及代码库中的任何显著更改或新增内容。这有助于审阅者快速理解 PR 的目的。
引用相关问题:在描述中链接到任何相关问题、讨论线程或功能请求。使用诸如“修复 #IssueNumber”之类的关键字,以便在 PR 合并时自动关闭问题。
为重大更改提供背景信息:如果 PR 涉及重大更改或重构,请简要说明为什么这些更改是必要的,以及它们如何改进项目。
记录新功能:如果 PR 引入了新功能,请确保文档(例如,README 更新、代码注释)包含在 PR 中或作为 PR 的一部分进行规划。
提供测试覆盖:如果适用,描述您为覆盖 PR 中的更改而添加的测试。这有助于审阅者评估代码是否健壮以及是否处理了潜在的边缘情况。
使用清晰的提交信息:每个提交信息都应该清晰并专注于一项更改或改进。提交标题应在 50 个字符以内描述更改,更多详细信息可以在提交正文中添加。
代码审查#
乐于接受反馈:审阅者可能会提出改进建议、指出错误或要求澄清。乐于接受建议,即使您最初不同意。将其视为一个加强代码的机会。
及时回复:通过评论承认反馈,解释您将如何解决问题或为什么某个更改可能不必要。保持沟通清晰和尊重有助于维持高效的审阅流程。
逐步更新您的 PR:根据审阅者反馈尽快应用更改。除非必要,避免强制推送更新,因为这可能会扰乱审阅流程和历史记录跟踪。
澄清不明确的反馈:如果您不确定某个评论,请在进行更改之前毫不犹豫地要求澄清。沟通不畅可能导致不必要的返工。
适当地使用建议:如果审阅者使用 GitHub 的建议功能,请根据需要接受或修改建议,同时确保 PR 保持与原始目标一致。
总结主要修订:如果 PR 在初始审阅后经历了重大修订,请总结新的更改,以便审阅者更清楚地了解已更新的内容。