歡迎來到 BeeWare Sprints!
歡迎您很高興您決定加入我們!如果您還沒有 如果您還沒有向蜜蜂團隊的成員自我介紹,請務必這樣做。一旦 完成後,請回到這裡開始。
什麼是衝刺?
sprint 是一個非組織性的機會,讓您可以花幾個小時或幾天的時間 在開放原始碼專案上合作。它們通常與 會議;會議後的衝刺活動提供了一個機會,將會議所產生的能量、熱忱和興趣 將會議所帶來的能量、熱忱和興趣 轉化為改善我們日常使用的軟體。
Sprints 也是一個機會,可以讓人們認識為專案貢獻的過程。 為專案做出貢獻的機會。我們希望您能在 sprint 期間享受到許多貢獻的樂趣 貢獻,以至於回家後繼續貢獻 貢獻!
[It doesn't matter how much experience you've got (/contributing/first-time/imposter-syndrome/)。在過去的 sprints 中、 我們合併了來自不同經驗層級的人的貢獻,包括 高中生、剛從 Bootcamp 畢業的人、不認為自己是程式設計師的人 認為自己不是程式設計師的人,以及經驗豐富的開發人員。無論您的 經驗等級 - 我們都能找到讓您貢獻的方法。
程式碼也不是您貢獻的唯一方式。像 BeeWare 項目需要的不僅僅是代碼 - 我們需要有人來編寫、校對和翻譯文檔、 我們需要人來編寫、校對和翻譯文件;我們需要人來改進 我們需要人來改善網頁的設計;甚至需要人來檢視多年前被報告的錯誤,並確認它們是否存在。 我們需要人來撰寫,校對和翻譯文件;我們需要人來改善網頁的設計;即使是檢視多年前報告的錯誤,並確認它們已經被修正的過程 都是寶貴的貢獻。
最初的問題
為了讓您開始學習,我們會問您幾個問題,以便評估 您的興趣和經驗。這將有助於我們找到最適合 您的貢獻。請仔細閱讀這些問題,做筆記,然後找到 蜜蜂團隊的成員,分享您的答案。如果您不明白 不要擔心!讓我們知道您 讓我們知道您所知道的,然後我們會一起找出答案。
** 您以前使用過 BeeWare 嗎?
如果您還沒有,請從 BeeWare 教學。它會為您 BeeWare 專案是什麼,以及該專案的各個部分是如何組合起來的。 的組合。如果您在 如果您在教學過程中遇到任何問題,請記錄下來,因為確保沒有人遇到相同的問題 因為確保別人不會遇到同樣的問題是首次貢獻的一個很好的主題!
當您至少完成教學到步驟 4 時,請移動到 下一個問題。
** 您帶有哪些電腦設備?
您隨身攜帶的設備限制了您 貢獻。舉例來說,如果您有一台 Windows 筆記型電腦,您將 就無法處理任何與 iOS 有關的工作。您的 筆記型電腦執行 Windows、macOS、Linux 或其他系統?您的手機是 是 iOS 或 Android 裝置?您的裝置是由您的 還是您自己的個人裝置?
** 您有多少編寫 Python 程式碼的經驗?
您是程式設計新手嗎?Python 老手?剛開始學習 Python 才剛開始學習 Python?剛從 bootcamp 課程的新畢業生?我們希望找到一個能符合 您的水平經驗。
**您熟悉 Github 的貢獻流程嗎?
您是否使用 GitHub(或類似的程式碼分享網站)來寄存您自己的程式碼或貢獻他人的專案? 自己的程式碼或貢獻他人的專案嗎?您知道什麼是 CI (持續整合)是什麼?您是否貢獻過 有預先提交鉤子的專案嗎?如果我要求您「針對 main",你知道該怎麼做嗎?
** 您之前有為開放原始碼專案做出貢獻嗎?
您過去參加過衝刺賽嗎?您曾經向開放原始碼專案提交過 PR (拉取請求)?您熟悉如何使用 使用 Github 創建 pull request?
** 您是否有其他可能有用的特殊技能?
您熟悉 GUI API(例如 Winforms、Cocoa 或 GTK)嗎? 您對特定作業系統的內部有深入的了解嗎? 作業系統的內部知識?您是 Python 以外的程式語言專家嗎? Python 以外的程式語言專家嗎?如果您沒有任何特殊技能,這不是問題。 但如果我們手上有一位 Windows 大師,我們希望 但如果我們手邊有一位 Windows 大師,我們希望確保這些技能得到善用。
**您為何要加入我們,您對什麼感興趣?
「您聽起來像是個友善的專案 」是個非常好的答案。 但是,如果您今天加入我們還有其他原因,請告訴我們。 您對行動或桌上型電腦開發有興趣嗎?包裝? 網站?控制台應用程式?如果您沒有特定的興趣 - 請告訴我們 根據您目前對BeeWare的了解,您對哪個領域最感興趣? 什麼最有趣?
現在,找一位蜜蜂團隊的成員來分享您的答案。他們可能會問 一些追蹤問題;但接下來他們會指給您一個方向,讓您可以在那裡做出貢獻。 您應該能有所貢獻的領域。
尋找您的問題
如果您與 Bee 團隊的成員交談過,他們可能會告訴您 BeeWare 專案中您可以貢獻的部分。 您可以在BeeWare項目中做出貢獻;他們甚至可能會建議您解決一個特定的問題。 甚至可能已經建議了一個特定的問題。如果他們沒有 如果他們沒有為您提供具體的問題,他們可能已經為您指出了該專案的 "Good First Issues"。 問題"。這是什麼意思呢?
GitHub 提供了一個問題列表,讓 BeeWare(以及其他 專案)追蹤所有被報告的問題 - 包括明確的bug、可能是bug的意外行為 包括明確的bug、可能是bug的意外行為、 對新功能的要求,對更多文件的要求--任何 任何 BeeWare 可以改進的地方。隨著新問題的 Bee團隊會將其中一些問題標記為 這些問題不需要即時修復,但卻是BeeWare可以改進的地方。 *不需要立即修復的問題,但有很好的定義或很容易重現,並可能 有很好的潛在原因。這些問題被標示為「良好的 first issue",使其更容易被找到。
若要依據「好的第一個問題」標籤篩選 GitHub 問題清單,請遵循以下步驟 這些步驟:
- 按一下問題清單上方的「標籤」按鈕以啟動 下拉式功能表。
- 在下拉式功能表上方的搜尋方塊中輸入「良好」一詞。 下拉式功能表。
- 按一下篩選清單中的「好的第一期」。
<圖
<圖示
一旦您找到看起來有趣的議題,請閱讀任何 評論,並在討論中發表評論,說明您正在研究這個問題 (例如:"Looking into this at PyCon US. 您正在研究這個問題 (例如:「在 PyCon US 2025 sprints 上研究這個問題")。BeeWare 並沒有明確「指派」問題 - 我們接受任何人的貢獻。 任何人的貢獻。然而,在 sprint 的情況下,我們需要 確保不會有兩個人在處理同一個問題。 留下註解是一種輕量級的協調方式。 貢獻者之間的協調。
如果您還是找不到您想做的事情,請找蜜蜂團隊的 成員,他們會幫助您縮小範圍,找出特定的問題。
設定開發環境
一旦發現問題,您需要設定您的開發 環境,以便進行修復。每個BeeWare專案都有自己的 貢獻指南:
如果專案不在此清單中,請查看專案 README,瞭解如何設定的詳細資訊。 如何設定。如果有任何說明不合理(或 您找不到這些說明),請找到 Bee 團隊的成員,他們會幫您解決問題。 他們會幫您解決問題。如果您認為可以改進 如果您認為您可以改善指南,使其他人不會遇到同樣的問題,那麼改善 貢獻指南是一個寶貴的貢獻!
現在您可以開始處理您的問題!
提交 PR 之後會發生什麼?
一旦您提交了拉取請求,並且拉取請求通過了 所有自動檢查,您就可以進行審查了。讓核心 團隊的成員知道您的 PR 已經準備好接受審核,他們會看一看。 看看。
如果這是您的第一份 PR,審核很可能會發現一些問題。 問題。這可能是您沒有考慮到的邊緣情況,或是您沒有遵循的程式碼 慣例。不要氣餒!沒有人 - 即使是 即使是核心團隊,也沒有人能在第一次嘗試時就 100% 正確地完成 PR。
一旦 PR 通過審核,您的審核員就會合併 PR - 您就大功告成了。 完成!恭喜 - 您已經為BeeWare做出了貢獻!如果這是您 您也獲得了BeeWare Challenge-Coins--找一位 核心團隊成員,他們會給您一枚硬幣!
Help!我卡住了
如果您在途中遇到困難,請找蜜蜂團隊的成員。 團隊的成員。不要害怕詢問*任何問題。如果您卡住了,我們希望 幫您解除困擾。如果您感到困惑,那是因為主題很複雜 複雜,而我們解釋得不夠清楚。我們渴望 幫助 - 我們希望確保您有一個成功的衝刺。
What if I don't complete my contribution during the sprint?
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!