您想幫助我們讓 Groovy 程式語言變得更好嗎?有許多方式可以讓您參與、發揮影響力,並幫助 Groovy 開發團隊讓 Groovy 變得更棒、更時髦?我們非常感謝並歡迎您的貢獻,您可以透過下列方式幫助我們
- 在 郵件清單 上協助其他使用者或討論未來的語言方向
- 在 Slack 上參與討論 - 此頻道未經 Apache 軟體基金會認可,由社群中的 Groovy 愛好者經營,用於休閒對話和問答
- 在我們的 錯誤追蹤器 中回報或修復您遇到的 問題
- 記錄 語言或其 API 的各個面向
- 撰寫部落格文章 關於 Groovy 功能或您的 Groovy 使用方式
- 建立或評論 Groovy 強化建議,其中說明我們如何對語言進行重大變更
- 改進此 網站
- 使用更多測試涵蓋程式碼庫,以避免未來的回歸
- 當然,透過 貢獻錯誤修正或新功能
在郵件清單和論壇上討論
如果您遇到問題、想討論新功能、分享有趣的發現等等,那麼 郵件清單 就是與 Groovy 開發人員和其他 Groovy 使用者開始對話的地方。郵件清單上的討論會被封存。這是進行所有正式討論或您想搜尋封存資料的地方。
或者,對於更輕鬆的對話和問答,請考慮使用 Slack 頻道。(此頻道未經 Apache 軟體基金會認可;它是由社群中的 Groovy 愛好者所經營。)
回報問題
如果您想要搜尋現有的問題、提出新的問題或熱衷於修復一些現有的問題,那麼您應該熟悉 Groovy 的 錯誤追蹤器。
在提交新問題之前,我們建議您閱讀我們的 回報問題指南
撰寫部落格文章
Groovy 有許多很棒的功能,有些人從未聽過。何不寫一篇關於您最喜歡的有趣文章。您可以使用自己的部落格平台,或為我們網站的 部落格部分 建立一個新的文章拉取請求,這些文章會發佈到我們自己的 部落格網站。
改善文件
Groovy 程式語言的文件有各種形式
- 參考文件涵蓋語言規格、使用者指南、入門等。
- GroovyDoc API 記錄 Groovy 程式碼庫的類別
- Groovy GDK 文件,說明 Groovy 如何豐富 JDK API
- 此 網站
若要為 Groovy 參考文件做出貢獻,這篇 部落格文章 提供了所有關於如何處理該文件的詳細資訊。
上述所有內容都儲存在我們的程式碼 Github 上的儲存庫 中,因此在 Github 上擁有帳戶會很理想。
如果您已經擁有 Github 帳戶,那麼為此網站做出貢獻相當容易,因為您可以按一下此網站所有頁面上看到的改善此文件按鈕。因此,請不要猶豫,幫助我們改善它、修正錯字、修正錯誤的語言、釐清複雜的部分、新增新資料等。
請查看以下部分,以取得更多關於如何為我們的程式碼庫做出貢獻的資訊。
貢獻程式碼
如果您知道您想貢獻的領域,這很好,但如果您正在尋找一些第一個貢獻,Groovy 開發團隊會嘗試維護一個 清單,其中列出可能的容易貢獻,可以讓您開始成為 Groovy 提交者的旅程。只要在 Groovy 開發人員 郵寄清單 上舉手,告訴我們您想處理該問題單的意願。
對於更複雜的任務,最好的方法也是讓 Groovy 開發人員注意到,這樣他們可以就如何最好地解決特定問題提供一些指導,討論實作想法以及提議變更的語意或範圍。
複製程式碼庫
若要處理 Groovy 程式碼庫,您應該對 git 夠熟練,而且您應該在 Github 上有一個帳戶,才能使用變更建立 拉取要求。
請分岔 https://github.com/apache/groovy,並根據 分岔儲存庫 中的說明建立分岔的本機複製。
請務必使用您在 Github 上註冊的相同電子郵件適當地設定 Git
git config --global user.name "YOUR NAME"
git config --global user.email "YOUR EMAIL"
您可以透過執行以下指令來驗證這些設定是否適當
git config --list
處理程式碼庫
如果您使用 IntelliJ IDEA 開發環境,這個 螢幕錄影 提供許多有關如何設定您的 IDE 的詳細資料。
然後,若要處理 Groovy 程式碼庫,建置和測試 Groovy,您可以遵循 Groovy 儲存庫中自述檔案中的 說明。
在傳送您的變更之前,您必須執行的最重要的指令是測試指令
./gradlew test
要成功貢獻,所有測試都應該是綠色的!
建立拉取要求
在您對變更感到滿意後
- 在您的本機分岔中提交您的變更
- 將您的變更推送到您在 Github 上的遠端分岔
- 寄送 pull request 給我們