衝刺指南¶
歡迎參加 BeeWare 衝刺活動！¶
歡迎您很高興您決定加入我們！如果您還沒有 如果您還沒有向蜜蜂團隊的成員自我介紹，請務必這樣做。一旦 完成後，請回到這裡開始。
什麼是衝刺？¶
sprint 是一個非組織性的機會，讓您可以花幾個小時或幾天的時間 在開放原始碼專案上合作。它們通常與 會議；會議後的衝刺活動提供了一個機會，將會議所產生的能量、熱忱和興趣 將會議所帶來的能量、熱忱和興趣 轉化為改善我們日常使用的軟體。
Sprints 也是一個機會，可以讓人們認識為專案貢獻的過程。 為專案做出貢獻的機會。我們希望您能在 sprint 期間享受到許多貢獻的樂趣 貢獻，以至於回家後繼續貢獻 貢獻！
無論你擁有多少經驗都無妨。在過往的衝刺階段中，我們整合了來自各經驗層級者的貢獻——高中生、剛從編程訓練營畢業的新手、不自認是程式設計師的人，以及資深開發者。無論你的經驗程度如何——我們都能為你找到貢獻的方式。
程式碼也不是您貢獻的唯一方式。像 BeeWare 項目需要的不僅僅是代碼 - 我們需要有人來編寫、校對和翻譯文檔、 我們需要人來編寫、校對和翻譯文件；我們需要人來改進 我們需要人來改善網頁的設計；甚至需要人來檢視多年前被報告的錯誤，並確認它們是否存在。 我們需要人來撰寫，校對和翻譯文件；我們需要人來改善網頁的設計；即使是檢視多年前報告的錯誤，並確認它們已經被修正的過程 都是寶貴的貢獻。
最初的問題¶
為了讓您開始學習，我們會問您幾個問題，以便評估 您的興趣和經驗。這將有助於我們找到最適合 您的貢獻。請仔細閱讀這些問題，做筆記，然後找到 蜜蜂團隊的成員，分享您的答案。如果您不明白 不要擔心！讓我們知道您 讓我們知道您所知道的，然後我們會一起找出答案。
- 您之前使用過 BeeWare 嗎？
若尚未開始，請先從BeeWare 教學指南著手。該指南將為您介紹 BeeWare 專案的整體架構，以及各組件如何相互協作。若在進行教學時遇到任何問題，請務必記錄下來——因為確保他人不再遭遇相同問題，正是您首次貢獻的絕佳切入點！
當您完成至少到步驟4的教學後，請繼續進行下一個問題。
- 您隨身攜帶哪些計算設備？
您隨身攜帶的設備會對您能參與的項目設下實際限制。舉例來說，若您使用的是 Windows 筆記型電腦，便無法處理任何與 iOS 相關的工作。您的筆記型電腦運行的是 Windows、macOS、Linux 還是其他系統？您的手機是 iOS 還是 Android 裝置？這些設備是由雇主提供，還是您個人的私有設備？
- 您擁有多少撰寫 Python 程式碼的經驗？
你是程式設計新手嗎？Python老手？還是資深程式設計師才剛開始學習Python？或是剛從訓練營畢業的新鮮人？我們希望能為你找到與你的經驗水平相匹配的課題。
- 您是否熟悉 GitHub 的貢獻流程？
您是否使用 GitHub（或類似程式碼共享平台）來託管自己的程式碼或參與他人專案？您是否了解 CI（持續整合）的含義？您是否曾參與過具備預提交掛鉤的專案？若我要求您「將您的 PR 對齊主分支」，您是否清楚該如何操作？
- 您是否曾為開源專案貢獻過？
您過去是否參加過衝刺會議？您是否曾向開源專案提交過拉取請求（PR）？您是否熟悉如何使用 GitHub 建立拉取請求？
- 您是否還具備其他可能派上用場的特殊技能？
您是否熟悉某種圖形使用者介面 API（例如 WinForms、Cocoa 或 GTK）？您是否對特定作業系統的內部運作有深入了解？您是否精通 Python 以外的程式語言？若您沒有特殊技能也無妨——但若我們手邊有位 Windows 專家，我們希望確保這些技能能發揮實質作用。
- 您為何加入我們，又對哪些領域感興趣？
「聽起來像是個友善的專案」是個完全合適的回答。不過，若您今天加入我們還有其他原因，請告訴我們。您對行動裝置或桌面開發感興趣嗎？包裝工程？網站開發？主機應用程式？若您沒有特定偏好——根據您目前對 BeeWare 的了解，哪個領域最吸引您？
現在，找一位蜜蜂團隊的成員來分享您的答案。他們可能會問 一些追蹤問題；但接下來他們會指給您一個方向，讓您可以在那裡做出貢獻。 您應該能有所貢獻的領域。
找出您的問題¶
若您曾與 Bee 團隊成員交流，他們很可能已為您指明 BeeWare 專案中可貢獻的領域；甚至可能推薦了具體的待辦事項供您著手。若未提供具體事項，他們通常會引導您查看該專案的「適合初學者的待辦事項」。這究竟意味著什麼？
GitHub 提供了一個問題列表，讓 BeeWare（以及其他 專案）追蹤所有被報告的問題 - 包括明確的bug、可能是bug的意外行為 包括明確的bug、可能是bug的意外行為、 對新功能的要求，對更多文件的要求–任何 任何 BeeWare 可以改進的地方。隨著新問題的 Bee團隊會將其中一些問題標記為 這些問題不需要即時修復，但卻是BeeWare可以改進的地方。 *不需要立即修復的問題，但有很好的定義或很容易重現，並可能 有很好的潛在原因。這些問題被標示為「良好的 first issue"，使其更容易被找到。
要根據「好初次問題」標籤篩選 GitHub 問題清單，請依循以下步驟：
- 點擊問題清單上方的「標籤」按鈕，即可開啟下拉式選單。
- 在下拉式選單頂端的搜尋框中輸入「好」這個字。
- 在篩選後的清單中點擊「好首期」。
透過「初學者適宜」標籤篩選 GitHub 問題。
一旦您找到看起來有趣的議題，請閱讀任何 評論，並在討論中發表評論，說明您正在研究這個問題 (例如："Looking into this at PyCon US. 您正在研究這個問題 (例如：「在 PyCon US 2025 sprints 上研究這個問題"）。BeeWare 並沒有明確「指派」問題 - 我們接受任何人的貢獻。 任何人的貢獻。然而，在 sprint 的情況下，我們需要 確保不會有兩個人在處理同一個問題。 留下註解是一種輕量級的協調方式。 貢獻者之間的協調。
如果您還是找不到您想做的事情，請找蜜蜂團隊的 成員，他們會幫助您縮小範圍，找出特定的問題。
建立開發環境¶
一旦發現問題，您需要設定您的開發 環境，以便進行修復。每個BeeWare專案都有自己的 貢獻指南：
如果專案不在此清單中，請查看專案 README，瞭解如何設定的詳細資訊。 如何設定。如果有任何說明不合理（或 您找不到這些說明），請找到 Bee 團隊的成員，他們會幫您解決問題。 他們會幫您解決問題。如果您認為可以改進 如果您認為您可以改善指南，使其他人不會遇到同樣的問題，那麼改善 貢獻指南是一個寶貴的貢獻！
現在您可以開始處理您的問題！
提交申請後會發生什麼事？¶
一旦您提交了拉取請求，並且拉取請求通過了 所有自動檢查，您就可以進行審查了。讓核心 團隊的成員知道您的 PR 已經準備好接受審核，他們會看一看。 看看。
如果這是您的第一份 PR，審核很可能會發現一些問題。 問題。這可能是您沒有考慮到的邊緣情況，或是您沒有遵循的程式碼 慣例。不要氣餒！沒有人 - 即使是 即使是核心團隊，也沒有人能在第一次嘗試時就 100% 正確地完成 PR。
一旦拉取請求通過審查，審查者便會合併該請求——至此大功告成！恭喜您——您已為 BeeWare 作出貢獻！若這是您首次為 BeeWare 貢獻，您還將獲得一枚 BeeWare 挑戰紀念幣——請找尋核心團隊成員，他們會將紀念幣頒發給您！
救命！我卡住了！¶
如果您在途中遇到困難，請找蜜蜂團隊的成員。 團隊的成員。不要害怕詢問*任何問題。如果您卡住了，我們希望 幫您解除困擾。如果您感到困惑，那是因為主題很複雜 複雜，而我們解釋得不夠清楚。我們渴望 幫助 - 我們希望確保您有一個成功的衝刺。
如果我在衝刺期間未能完成我的貢獻該怎麼辦？¶
沒問題！您隨時都可以提交貢獻。衝刺活動的目標之一，就是鼓勵並賦予您力量，讓您能在接下來的整年持續貢獻。蜜蜂團隊隨時準備協助您處理這個過程的任何環節。
若您已於 GitHub 問題追蹤系統進行協作或提交了拉取請求，可繼續透過 GitHub 進行溝通。若有其他疑問或需要即時協助，最理想的聯繫管道是 BeeWare Discord 伺服器。我們期待與您持續合作！
改進本指南¶
如果您對如何改進這份衝刺指南有任何建議，請告訴我們。 哪些方法對您有效？哪些沒有用？哪些可以做得更好？請記住 對BeeWare的貢獻！