欢迎来到 BeeWare Sprints！
欢迎您很高兴您决定加入我们！如果您还没有 如果您还没有向蜜蜂团队的成员自我介绍，请尽快。一旦 一旦您完成了自我介绍，请返回这里开始您的工作。
什么是冲刺？
冲刺是一个非结构化的机会，可以花几个小时或几天的时间 协作完成开源项目的机会。它们通常与 会议；会议之后的冲刺阶段提供了一个机会，可以 将会议带来的能量、热情和兴趣 将会议带来的能量、热情和兴趣转化为对我们日常使用软件的改进。
冲刺也是向人们介绍如何为项目做出贡献的机会。 为项目做出贡献。我们希望您能在冲刺阶段获得极大的乐趣 在冲刺阶段做出贡献，回家后继续做出贡献 继续作出贡献！
你有多少经验并不重要。在过去的冲刺 (sprints)，我们合并了来自不同经验水平的人的贡献，包括高中生、刚从训练营毕业的人、不认为自己是程序员的人，以及经验丰富的开发人员。无论您的经验水平，我们都能为您找到贡献的方式。
代码也不是您做出贡献的唯一方式。像 BeeWare 这样的项目需要的不仅仅是代码--我们需要有人来撰写、校对和翻译文档；我们需要有人来改进网页的设计；我们甚至需要有人来检查多年前报告过的错误，并确定它们是否已经被修复，也是一项宝贵的贡献。
最初的问题
首先，我们会问您几个问题，以便了解您的兴趣和经验。这将帮助我们找到您贡献的最佳方式。请仔细阅读这些问题，做好笔记，然后找到蜜蜂团队的成员，分享您的答案。如果您不理解问的问题，不用担心！让我们知道你所知道的，我们会一起从那里开始。
您以前使用过 BeeWare 吗？
如果您还没有阅读过 BeeWare 教程，不妨先学习它。它将为您介绍什么是 BeeWare 项目，以及项目的各个部分是如何组合在一起的。如果您在学习过程中遇到任何问题，记录下来，因为确保没有人遇到同样的问题是首次贡献的一个很好的主题！
一旦你完成了至少第 4 步的教程，请继续下一个问题。 下一个问题。
您携带了哪些计算机设备？
您随身携带的设备限制了您 的实际限制。例如，如果你有一台 Windows 笔记本电脑，那么你就 就无法处理任何与 iOS 有关的工作。你的 笔记本电脑运行的是 Windows、macOS、Linux 还是其他系统？你的手机是 是 iOS 还是 Android 设备？你的设备是由你的 还是个人设备？
你有多少编写 Python 代码的经验？
您是编程新手？Python 老手？编码老手 刚刚开始学习 Python 的编码老手？刚从 新兵训练课程的应届毕业生？我们希望找到一个与您的 您的水平经验相匹配的问题。
你熟悉 Github 的贡献流程吗？
您是否使用 GitHub（或类似的代码共享网站）托管自己的代码或贡献他人的项目？ 托管自己的代码或为他人的项目做贡献？您知道什么是 CI (持续集成）是什么？您是否参与过 有预提交钩子的项目？如果我要求你 "针对 main"，你知道该怎么做吗？
你以前为开源项目做出过贡献吗？
您参加过冲刺赛吗？您向开源项目提交过 PR (拉取请求）？您熟悉如何 使用 Github 创建拉取请求？
你是否还有其他有用的特殊技能？
您熟悉图形用户界面 API（如 Winforms、Cocoa 或 GTK）吗？ 你对特定操作系统的内部结构有深入了解吗？ 操作系统的内部知识？您是 Python 之外的编程语言专家吗？ 以外的编程语言专家？如果您没有任何特殊技能，这不是问题。 但如果我们手上有一位 Windows 专家，我们希望 确保这些技能得到很好的利用。
**你为什么加入我们，对什么感兴趣？
"你听起来像是一个友好的项目 "是一个很好的答案。 但是，如果您今天加入我们还有其他原因，请告诉我们。 您对移动开发还是桌面开发感兴趣？包装？ 网站？控制台应用程序？如果您没有特定的兴趣，那么 根据您目前对BeeWare的了解，您对什么最感兴趣？ 最感兴趣的是什么？
现在，找一位蜜蜂小组成员来分享您的答案。他们可能会问 他们可能会问一些后续问题；但随后他们会给你指出一个方向，在那里你应该能够做出贡献。 你应该能够做出贡献的领域。
查找您的问题
如果您与蜜蜂团队的成员交谈过，他们可能会向您指出您可以为BeeWare项目做出贡献的地方。 您可以为BeeWare项目做出贡献；他们甚至可能会建议您解决某个具体问题。 甚至可能建议您解决某个具体问题。如果他们没有 问题，他们可能会向您推荐该项目的 "好问题"。 首批问题"。这意味着什么？
GitHub 提供的问题列表可让 BeeWare（及其他 和其他项目）跟踪所有已报告的问题。 这包括明确的错误、可能是错误的意外行为、 对新功能的请求、对更多文档的请求--任何 任何可能改进BeeWare的方法。随着新问题的 蜜蜂团队会将其中的一些问题标记为非常适合首次贡献者的问题。 这些问题并不要求立即解决，但却很有价值。 立即修复，但定义明确或易于重现的问题，并且很可能 对根本原因有很好的线索。这些问题被标记为 "好 第一个问题 "标签，以方便查找。
要按 "好的第一个问题 "标签筛选 GitHub 问题列表，请按以下步骤操作 以下步骤
- 点击问题列表上方的 "标签 "按钮，激活下拉菜单。 下拉菜单。
- 在下拉菜单顶部的搜索框中输入 "好 "字。 下拉菜单。
- 点击筛选列表中的 "好的第一期"。
<图
<img src="./github-good-first-issue-filter.png
alt="./github-good-first-issue-filter.png" /> </p
找到感兴趣的问题后，阅读帖子上的评论，并在讨论中发表评论说 评论，并在讨论中发表评论，说明您正在研究该问题（例如，"在 PyCon 美国大会上研究这个问题"）。 您正在研究这个问题（例如，"在 PyCon US 2025 冲刺阶段研究这个问题"）。BeeWare 不会明确 "分配 "问题 - 我们接受任何人的贡献。 任何人的贡献。但是，在冲刺阶段，我们需要 但在冲刺阶段，我们需要确保不会出现两个人同时处理同一个问题的情况。 留下评论是在贡献者之间进行协调的一种轻量级方法。 贡献者之间的协调。
如果您仍然找不到您想做的事情，请联系蜜蜂团队的 成员，他们会帮助您缩小范围，找到具体问题。
建立开发环境
发现问题后，您需要设置开发环境，以便修复问题。 环境，以便解决问题。每个 BeeWare 项目都有自己的 贡献指南：
- 公文包](https://briefcase.readthedocs.io/en/latest/how-to/contribute/index.html)
- 托加](https://toga.readthedocs.io/en/latest/how-to/contribute/index.html)
- Rubicon ObjC](https://rubicon-objc.readthedocs.io/en/latest/how-to/contribute/index.html)
如果项目不在此列表中，请查看项目 README，了解如何设置的详细信息。 如何设置。如果有任何说明不合理（或 或找不到相关说明），请联系蜜蜂团队的成员，他们会帮您解决困难。 他们会帮您解决问题。如果您认为可以改进 如果您认为可以改进指南，使其他人不会遇到同样的问题，那么改进 贡献指南是一项宝贵的贡献！
现在，您可以开始解决您的问题了！
提交 PR 之后会发生什么？
一旦您提交了拉取请求，并且拉取请求通过了 所有自动检查后，您就可以进行审核了。让核心 团队中的一位成员知道您的 PR 已准备好接受审核，他们会看一下 看看。
如果这是您的第一次公关，审查很可能会发现一些问题。 问题。这可能是你没有考虑到的边缘情况，也可能是你没有遵循的代码 约定。不要气馁！没有人 第一次就能 100% 正确地完成 PR。
一旦 PR 通过审核，您的审核员就会合并 PR - 然后您就完成了。 完成！恭喜--您为BeeWare做出了贡献！如果这是您 您还获得了BeeWare 挑战币 - 找到一位 核心团队成员，他们就会给您一枚硬币！
Help！我卡住了
如果您在途中遇到困难，请联系蜜蜂团队的成员。 团队的成员。不要害怕提出任何问题。如果您遇到困难，我们希望 让您摆脱困境。如果您感到困惑，那是因为主题复杂，而我们还没有解释清楚。 复杂，而我们解释得还不够清楚。我们渴望 帮助--我们希望确保您有一个成功的冲刺。
如果我在冲刺时没有完成贡献怎么办？
No problem! You can submit a contribution at any time. A goal of the sprints is to encourage and empower you to continue contributing throughout the rest of the year. The Bee Team are available to help with any part of this process.
If you were already working on a GitHub issue or submitted a PR, you can continue to communicate through GitHub. If you have other questions or need real-time help, the best place to find us is the BeeWare Discord server. We're looking forward to continuing to work with you!