欢迎来到 BeeWare 冲刺!
欢迎!很高兴您决定加入我们!如果您还没有向蜜蜂团队的成员自我介绍,请尽快这样做。一旦您完成了自我介绍,请返回这里开始您的工作。
什么是冲刺?
冲刺是一个非结构化的机会,可以花几个小时或几天的时间在开源项目上协作工作。它们通常与会议相关联;会议之后的冲刺阶段提供了一个机会,可以将会议带来的能量、热情和兴趣转化为对我们日常使用软件的改进。
冲刺也是向人们介绍如何为项目做出贡献的机会。我们希望您能在冲刺时获得极大的乐趣,大到您回家后会继续贡献!
你有多少经验并不重要。在过去的冲刺 (sprints),我们合并了来自不同经验水平的人的贡献,包括高中生、刚从训练营毕业的人、不认为自己是程序员的人,以及经验丰富的开发人员。无论您的经验水平,我们都能为您找到贡献的方式。
代码也不是您做出贡献的唯一方式。像 BeeWare 这样的项目需要的不仅仅是代码--我们需要有人来撰写、校对和翻译文档;我们需要有人来改进网页的设计;我们甚至需要有人来检查多年前报告过的错误,并确定它们是否已经被修复,也是一项宝贵的贡献。
最初的问题
首先,我们会问您几个问题,以便了解您的兴趣和经验。这将帮助我们找到您贡献的最佳方式。请仔细阅读这些问题,做好笔记,然后找到蜜蜂团队的成员,分享您的答案。如果您不理解问的问题,不用担心!让我们知道你所知道的,我们会一起从那里开始。
您以前使用过 BeeWare 吗?
如果您还没有阅读过 BeeWare 教程,不妨先学习它。它将为您介绍什么是 BeeWare 项目,以及项目的各个部分是如何组合在一起的。如果您在学习过程中遇到任何问题,记录下来,因为确保没有人遇到同样的问题是首次贡献的一个很好的主题!
一旦你至少完成了教程 4,请继续回答下一个问题。
您携带了哪些计算机设备?
您随身携带的设备为您可以贡献的地方提供了实际限制。例如,如果你有一台 Windows 笔记本电脑,那么你就无法处理任何与 iOS 有关的工作。你的笔记本电脑运行的是 Windows、macOS、Linux 还是其他系统?你的手机是 iOS 还是 Android 设备?你的设备是由你的雇主提供的,还是个人设备?
你有多少编写 Python 代码的经验?
您是不是编程新手?Python 老手?刚刚开始学习 Python 的编码老手?编码训练营 (bootcamp) 的应届毕业生?我们希望找到一个与您的您的水平经验相匹配的问题。
你熟悉 GitHub 贡献流程吗?
您是否使用 GitHub(或类似的代码共享网站)托管自己的代码或为他人的项目做贡献?您知道什么是 CI (持续集成) 是什么?您是否参与过有预提交钩子 (pre-commit hooks) 的项目?如果我让你 “rebase your PR against main”,你知道该怎么做吗?
你以前为开源项目做出过贡献吗?
您在这之前参加过一场代码冲刺吗?您是否向开源项目提交过 PR(拉取请求)?您熟悉怎样用 GitHub 提交拉取请求吗?
你是否还有其他有用的特殊技能?
您熟悉一个图形用户界面 API(如 WinForms、Cocoa 或 GTK)吗?你对某种操作系统的内部结构有深入了解吗?您是在一种 Python 之外的编程语言的专家吗?如果您没有任何特殊技能也没问题 -- 但如果我们手上有一位 Windows 专家,我们希望确保这些技能得到好的利用。
你为什么加入我们,对什么感兴趣?
“你听起来像是一个友好的项目”是一个很好的答案。但是,如果您今天加入我们还有其他原因,请告诉我们。 您对移动开发还是桌面开发感兴趣?包装?网站?控制台应用程序?如果您没有特定的兴趣,那么根据您目前对 BeeWare 的了解,您对什么最感兴趣?
现在,找一位蜜蜂团队成员来分享您的答案。他们可能会问您一些后续问题;但随后,他们会给你指出你应该能够做出贡献的方向。
查找您的问题
如果您与蜜蜂团队的成员交谈过,他们可能会向您指出您可以为 BeeWare 项目做出贡献的地方,甚至可能会建议您解决某个具体问题。如果他们没有给您一个具体问题,他们可能会向您推荐该项目的 “Good First Issues”。这是什么意思?
GitHub 提供的问题列表可让 BeeWare(及其他项目)跟踪所有已报告的问题。这包括明确的错误、可能是错误的意外行为、对新功能的请求、对更多文档的请求--任何可以改进 BeeWare 的方法。随着新问题的报告,蜜蜂团队会将其中的一些问题标记为非常适合首次贡献者的问题。这些问题并不要求立即解决,但定义明确或易于重现,并且很可能 对根本原因有很好的线索。这些问题被标记为 “good first issue” 标签,以方便查找。
要按 “good first issue” 标签筛选 GitHub 问题列表,请按以下步骤操作:
- 点击问题列表上方的 “Labels” 按钮,激活下拉菜单。
- 在下拉菜单顶部的搜索框中输入“good”。
- 点击筛选列表中的 “good first issue”。

找到感兴趣的问题后,阅读帖子上的评论,并在讨论中发表评论,说明您正在研究这个问题(例如,“Looking into this at the PyCon US 2025 sprints”)。BeeWare 不会明确“分配”问题 - 我们接受任何人的贡献。但是,在冲刺时,我们需要确保不会出现两个人同时处理同一个问题的情况。留下评论是在贡献者之间进行协调的一种轻量级方法。
如果您仍然找不到您想做的事情,请联系蜜蜂团队的成员,他们会帮助您缩小范围,找到具体问题。
配置您的开发环境
发现问题后,您需要设置开发环境,以便修复问题。每个 BeeWare 项目都有自己的贡献指南:
如果项目不在此列表中,请查看项目 README,了解如何配置的详细信息。如果有任何说明不合理(或找不到相关说明),请联系蜜蜂团队的成员,他们会帮您解决困难。如果您认为可以改进指南,使其他人不会遇到同样的问题,那么改进贡献指南也是一项宝贵的贡献!
现在,您可以开始解决您的问题了!
提交拉取请求之后会发生什么?
一旦您提交了拉取请求,并且拉取请求通过了所有自动检查后,您就可以请求审核了。让核心团队中的一位成员知道您的 PR 已准备好接受审核,然后他们就会来看看。
如果这是您的第一个 PR (拉取请求),审查时我们很可能会发现一些问题。这可能是你没有考虑到的边缘情况,也可能是你没有遵循的代码约定。不要气馁!没有人第一次就能 100% 正确地完成 PR。
一旦 PR 通过审核,您的审核员就会合并 PR - 然后您就完成了。恭喜您 -- 您为 BeeWare 做出了贡献!如果这是您的第一次 BeeWare 贡献,您还获得了BeeWare 挑战币 -- 找到一位核心团队成员,他们将会给您一枚硬币!
帮帮我!我卡住了!
如果您在途中遇到困难,请联系蜜蜂团队的成员。不要害怕提出任何问题。如果您遇到困难,我们希望让您摆脱困境。如果您感到困惑,那是因为主题复杂,而我们还没有解释清楚。我们渴望帮助--我们希望确保您有一个成功的冲刺。
如果我在冲刺时没有完成贡献怎么办?
没问题!您全年都可以提交贡献。冲刺的目的之一也是为了鼓励您在一年的其他时间继续作出贡献,且让您有能力这样做。蜜蜂团队将可以在这整个过程中提供任何您所需要的帮助。
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!