提供拉取请求的审查¶

我们始终乐于接受投稿人的评论，无论其经验水平如何。

为什么要审查会费？¶

提交的每一份贡献都需要经过审核，无论它是由核心团队成员提交还是首次提交。每个人都有可能遗漏某些内容。审核流程的建立就是为了提供额外的安全网。

审核流程的目的是确保所有内容（包括代码和文档）尽可能无错误且易于维护。我们欢迎您为实现这一目标做出任何贡献。这可能包括简单的纠正错别字，也可能包括发现 API 使用中未被捕捉到的边缘情况。您可以找出测试机制更强大的方法，或者提出建议，说明如何构建变更的整体架构，使其更易于维护或扩展。

我可以审查吗？¶

是的！您可以对BeeWare}上打开的任何拉取请求进行审核。

作为首次贡献者，您可以随意查看您发现的任何拉取请求，即使它是由核心团队成员提交的。如果您是新手，可能会忽略一些大的项目背景；但无论您的经验水平如何，我们的目标都是保持代码库的易用性。如果代码中存在不合理的地方，这可能表明需要更多的文档（可以是代码中的文档，也可以是独立的设计文档）。

提交拉取请求审查¶

提供拉取请求的审查

欢迎大家对 BeeWare 项目做出任何贡献。在开始之前，我们需要注意一些重要事项。

审查前请思考¶

在进行评论之前，请深思熟虑。作为审稿人，我们应该考虑一下我们即将发出的回复是否：

确实如此。始终努力提供准确的建议和信息。
有帮助。我们正在就如何改进提交材料提供指导；该指导应明确指出问题的根源或未考虑的用例，最好能提供解决或消除顾虑的途径。
激励。我们要做的就是激发作者的灵感，让他们愿意按照我们的要求进行修改。
必要。我们期望作者会阅读我们发布的所有内容；我们必须尊重他们的时间和精力，只在必要时发布。
善意。同样的反馈有多种表达方式；我们需要确保自己的言辞是善意的、支持性的和建设性的。

既要思考，又要提供有效的评论是完全可能的。以上讨论的概念并不排除指出您在 PR 中发现的任何问题。如果投稿人没有意识到需要改进的地方，他们就没有机会改进自己的投稿。重要的是要注意**你是如何提出这些反馈意见的。尽量使你的审查非个人化。与其说 "你犯了一个错误"，不如说 "这段代码可以改进"。审查代码，而不是作者。

除了找出需要改进的地方，提供积极的反馈也很重要。例如，如果改动特别有用、做得特别巧妙，或者向你介绍了一个你不知道的应用程序接口，请告诉作者！千万不要低估在你指出的其他问题都需要解决的情况下，指出别人做得正确或好的地方的效果。

GitHub 审核建议¶

GitHub 的审核界面有一个变更建议机制，您可以在其中提供您所建议的确切变更，作为现有内容的替代。请记住，在这些建议被接受并提交之前，它们不会通过预提交和过滤检查。因此，该功能应该用于较小的更改，因为建议的更改越大，引入问题的可能性就越大。