投稿指南¶

為 BeeWare. 這些指南涵蓋了您提供貢獻所需了解的一切內容。

我能做什麼？¶

修正問題 ¶

您可以做出的最顯著的貢獻就是編寫程式碼來修正已知的問題。

執行新功能 ¶

BeeWare 是否缺少您希望看到的功能？您可以實作新功能。

寫入文件 ¶

除非有完善的文件記錄，否則任何功能都不算完整。撰寫文件是一種不需要撰寫程式碼的貢獻方式。

處理問題 ¶

每次有人回報新的問題時，該問題就需要被分流。分流問題包括利用報告者提供的資訊，並嘗試重現他們所描述的問題。

檢閱拉取請求 ¶

一旦提交了 pull request，在合併之前就需要審閱。無論您是否對內容非常熟悉，您都可能有辦法協助審閱拉取請求。

建議新功能 ¶

您對BeeWare的工具有新的建議或想法嗎？您可以提出新功能以供考慮。

翻譯內容 ¶

BeeWare 以多種語言維護各種文件。如果您懂英語以外的語言，您可以協助翻譯內容。

使用工具 ¶

您有使用 Toga 建立應用程式的想法嗎？您是否有現有的應用程式可以套用 Briefcase？您可以使用工具，並提供經驗回饋。

我該如何貢獻？¶

建立開發環境 ¶

在您開始為 BeeWare 做出貢獻之前，您需要設定您的開發環境。

重現問題 ¶

在修復問題之前，您需要驗證問題是否存在。重製問題也是分流的重要部分。

從分支工作 ¶

準備提交貢獻時，請務必從分支開始工作。

避免範圍擴大 ¶

重要的是要保持專注，並且避免範圍蠕變，做出您的貢獻。

提出一項新功能 ¶

您將依照以下步驟來提出新功能。

編寫、執行並測試程式碼 ¶

若要更新或貢獻程式碼，您需要撰寫、執行並測試您的程式碼。

建立文件 ¶

若要更新或貢獻文件，您需要能夠建立文件。

寫入文件 ¶

要貢獻文件，您需要撰寫新內容或更新現有內容。

新增變更說明 ¶

每個 pull 請求都應附有變更備註。

提交 pull request ¶

一旦您的變更準備就緒，您將提交拉取請求以供審核。

提供檢閱 ¶

如果您覺得舒服，您可以提供他人貢獻的評論。

翻譯內容 ¶

BeeWare 使用 Weblate 進行翻譯，需要幾個步驟才能開始使用。

提交新問題 ¶

如果您遇到新的問題或 bug，提交問題會很有幫助。

接下來會發生什麼？¶

拉取請求審查 ¶

拉取請求提交後，下一步就是 PR review。

釋放程序 ¶

合併的貢獻將經過發行程序。

風格指南¶

指南樣式代碼 ¶

這些是BeeWare專案的程式碼貢獻準則。

文件樣式指南 ¶

這些是為BeeWare專案貢獻文件的準則。