我該怎麼辦？

任何開放原始碼貢獻的最佳起點是適合您的知識、經驗和感興趣的領域。

在您開始之前

在您開始貢獻之前，先了解整個專案作為一個整體。如果您還沒有完成 BeeWare 教學，請從那裡開始。這將讓您最重要的 BeeWare 工具，這樣您就可以了解它們是如何整合在一起的。它們是如何組合在一起的。

完成該教程後，您就可以挑選一些工作。如果您在做教程時遇到任何問題 - 如果您碰到一個錯誤，或是描述某個步驟的語言不清楚 - 那就是一個很好的起點! 這是一個很好的起點*！如果您能將您的經驗轉化為如果您能將您的經驗轉化為教學的改進，那麼下一個學習這套教學的人就不會遇到同樣的問題。遇到同樣的問題。

不過，如果您的教學體驗完全順利（我們希望如此我們也希望如此！），以下是一些可參與的構想，視您的技能和興趣而定。您的技能和興趣。

Python 程式設計

公事包

如果您想要貢獻給一個有明確問題說明的工具但需要解決錯誤和增加功能的工具、公文包可能是適合您的專案。您的專案。Briefcase 是一個將 Python 專案打包成獨立的 GUI 應用程式。它接受一個 pyproject.toml 配置檔，並使用該配置資料產生安裝程式。使用該組態資料來產生安裝程式或可發佈的應用程式包。

公事包問題 tracker 收集了功能建議 (以及少量的錯誤)。如果這是您第一次貢獻，請尋找標有 good 第一次問題 - 這些是特別挑選出來的問題。這些都是特別為初次貢獻者挑選的問題貢獻者，因為它們應該比較容易實作。實作。您也可能會發現，針對您實際使用的開發平台來篩選 Ticket 會很有幫助。您實際上使用的開發平台 - 如果您不使用如果您沒有 Linux 機器可用來測試，就很難修正 Linux bug！

如果您想為特定專案貢獻心力，您也可以使用這些連結，依特定專案篩選出優質的第一期期刊：

選取一個票單，留下您正在研究問題的評論，並嘗試開發一個拉取請求以實現修正！

GUI 程式設計

如果您有使用原生 widget 函式庫的經驗 - MacOS 上的 Cocoa、 Linux上的GTK+、Windows Forms，或是原生的iOS或Android函式庫、 Toga](https://github.com/beeware/toga) 提供協助。 Toga 是一個跨平台的 widget 工具包 - 它提供一個共通的介面 Toga 是一個跨平台的 widget 工具包 - 它提供了一個通用的介面給使用者介面元素，例如按鈕和樹狀圖。

Toga 已經定義了一系列的介面；然而，這些介面在所有平台上的實作並不完整。這些介面的實作並未在所有平台上完成。請選擇一個 widget，並針對您所選擇的平台實作該 widget！

即使您**不知道本機 Widget 函式庫，您也可以 Toga 幫上忙。編寫新的 widget 遠沒看起來那麼複雜。看起來沒那麼複雜。每個平台都有說明如何使用其原生 API 的說明文件，而將平台說明文件從其他語言（例如語言 (例如 Objective C 或 C#)翻譯平台說明文件的過程相對來說並不複雜。直接的過程。現有的程式碼應該會給您一些指針 BeeWare 團隊很樂意提供協助。如果您需要幫助，BeeWare 團隊也很樂意提供幫助。跳到 BeeWare Discord，我們會盡我們所能提供幫助。我們將竭盡所能提供幫助！

Even if you're not up for transforming code from one language to another, Toga's core library — as well as Travertino, a subpackage covering styling and layout — are pure Python, and platform-agnostic. Take a look at issues not tagged with a specific platform — many of them can probably be fixed with little or no change to any platform-specific code.

文件

良好的文件記錄對任何成功的專案而言都是不可或缺的。我們知道 Toga 和 Briefcase都需要顯著的改善他們的文件。您已經完成了教學；現在來看看看看 Toga和 Briefcase 的說明文件。公文包的說明文件，看看您是否能找到的教學、參考資料和專題指南。在那裡。

Tutorials

貢獻的最佳方式之一，就是確保我們的入門與教學文件教學文件的穩固性。從 BeeWare 套件中挑選一個感興趣的專案，並嘗試依照入門指南和教程。如果您找不到*入門指南，那麼首先要報告的就是這一點！

在您閱讀本教程時，請注意任何不合理或無法運作的地方。或無法運作的地方。然後針對這些問題開啟錯誤報告。

視窗

如果您是 Windows 使用者，BeeWare 絕對*需要您的協助。我們的核心團隊在日常開發中都會使用 Linux 和 macOS。因此，Windows 的不兼容性很容易就會溜進來。這幾乎都是因為疏忽所致。識別甚至在 Windows 上運行 BeeWare 工具的問題是一個巨大的幫助。幫助。

語言

您會說英語以外的語言嗎？目前，核心團隊均以英語為母語。提供翻譯的文件的翻譯，或以您的母語提供全新的教學或指南語言提供翻譯文件，或全新的教學或指南，都是很好的貢獻方式。選擇一個已經有文件並翻譯這些文字。或者，從頭開始撰寫全新的教學。

如果您使用的語言是非拉丁字符集的語言（例如俄語或中文），或使用從右至左文字的語言（如希伯來文或阿拉伯語）的語言，您可以指出我們在哪些地方假設了簡單的 ASCII 編碼或從左至右的慣例。選擇任何一個嘗試用您的母語來使用它。語言。如果您遇到任何問題，請將這些問題回報為 Bug；如果您覺得自己很冒險，看看是否有辦法解決這些問題。如果您覺得特別冒險，看看您是否能找出如何修正錯誤。

實際用途

對於我們來說，要確定我們在文件和API方面的差距，最好的方法之一就是讓人們實際使用BeeWare來建立自己的系統。的最佳方法之一，就是讓人們實際使用BeeWare來建立一些東西。東西。所以，如果目前的想法聽起來都不太有趣，為什麼不嘗試您自己的想法？使用BeeWare套件建立您夢寐以求的應用程式您一直夢寐以求的應用程式--一個數據源的桌面可視化，或者一個追蹤您的活動的移動應用程式--無論是什麼。行動應用程式來追蹤您的活動 - 無論是什麼，試著建立它。

我們幾乎可以保證您會遇到問題。BeeWare還是一個非常年輕的專案。但是您所遇到的問題會給我們一個很好的需要解決的問題。它會告訴我們哪些文件需要改進。因此，當您問題時，請記錄BeeWare專案中的問題。的問題。這將使我們能夠確定需要改進的地方。而且，這甚至可能成為您貢獻的靈感來源。做出貢獻！