参与其中

您想帮助我们让 Groovy™ 编程语言变得更好吗?您可以通过许多方式参与其中,发挥作用,并帮助 Groovy 开发团队让 Groovy 变得更好(更酷)?我们非常感谢并欢迎您的贡献,您可以通过以下方式帮助我们:

  • 邮件列表上帮助其他用户或讨论未来的语言方向
  • Slack上参与讨论 - 此频道未经 Apache 软件基金会认可,它由社区中的 Groovy 爱好者运营,用于休闲对话和问答,
  • 在我们的错误跟踪器中报告或修复您遇到的问题
  • 撰写文档,介绍语言或其 API 的各个方面
  • 撰写博客文章,介绍某些 Groovy 功能或您的 Groovy 用法
  • 创建或评论Groovy 增强提案,这些提案描述了我们如何对语言进行重大更改
  • 改进这个网站
  • 用更多测试覆盖代码库,以避免未来的回归,
  • 当然,还可以通过贡献错误修复或新功能

在邮件列表和论坛上讨论

如果您遇到问题,想讨论新功能,分享有趣的发现等等,那么邮件列表是与 Groovy 开发人员和其他 Groovy 用户开始对话的地方。邮件列表上的讨论会存档。这是所有正式讨论的地方,或者如果您想搜索存档。

或者,对于更休闲的对话和问答,请考虑使用Slack频道。(此频道未经 Apache 软件基金会认可;它由社区中的 Groovy 爱好者运营。)


报告问题

如果您想搜索现有问题、提出新问题或热衷于修复一些现有问题,那么您应该熟悉 Groovy 的错误跟踪器

在提交新问题之前,我们建议您阅读我们的报告问题指南


撰写博客文章

Groovy 有许多很棒的功能,有些人从未听说过。为什么不写一篇关于您最喜欢的功能的有趣文章呢?您可以使用自己的博客平台,或者在我们的网站的博客部分为新文章创建拉取请求,这些文章将发布到我们自己的博客网站


改进文档

Groovy 编程语言的文档有多种形式

要为 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 仓库中 readme 文件中的说明进行操作。

在发送更改之前,您必须运行的最重要命令是测试命令

./gradlew test

要成功贡献,所有测试都应该通过!

创建拉取请求

一旦您对更改感到满意

  • 将您的更改提交到您的本地分支
  • 将您的更改推送到您在 Github 上的远程分支
  • 向我们发送拉取请求

子项目

以下子项目在 Groovy 项目的赞助下运行

  • Geb 是一个浏览器自动化解决方案。

捐赠给 Groovy Open Collective 的朋友

作为一项独立倡议,更广泛的 Groovy 社区成员为 Groovy 设立了一个开放集体:Groovy Open Collective 的朋友。这项倡议旨在补充 Apache 项目以及我们从伟大社区和支持者那里获得的许多贡献。


构建状态

得益于我们的持续集成服务器,Groovy 源代码已通过测试。