您是否想帮助我们使 Groovy 编程语言变得更好?您可以通过多种方式参与其中,做出贡献并帮助 Groovy 开发团队使 Groovy 变得更加 groovy。我们非常感谢并欢迎您的贡献,您可以通过以下方式帮助我们
- 在 邮件列表 上帮助其他用户或讨论未来的语言方向
- 参与 Slack 上的讨论 - 此频道未经 Apache 软件基金会认可,由社区中的 Groovy 爱好者运营,用于进行非正式的对话和问答,
- 报告或修复您在我们的 错误跟踪器 中遇到的 问题
- 记录 语言或其 API 的各个方面
- 撰写一篇关于 Groovy 功能或您如何使用 Groovy 的博客文章
- 创建或评论 Groovy 增强提案,这些提案描述了我们如何对语言进行重大更改
- 改进此 网站
- 用更多测试覆盖代码库以避免未来的回归,
- 当然,还可以通过 贡献错误修复或新功能
在邮件列表和论坛上讨论
如果您遇到问题,想要讨论新功能,分享有趣的发现等等,那么 邮件列表 是与 Groovy 开发人员和其他 Groovy 用户开始对话的地方。邮件列表上的讨论已存档。它是进行所有正式讨论或搜索档案的地方。
或者,对于更非正式的对话和问答,请考虑使用 Slack 频道。(此频道未经 Apache 软件基金会认可;由社区中的 Groovy 爱好者运营。)
报告问题
如果您想搜索现有问题,提出新问题或热衷于修复一些现有问题,那么您应该熟悉 Groovy 的 Bug 跟踪器。
在提交新问题之前,建议您阅读我们的 报告问题 指南
撰写博客文章
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 上的远程分支
- 向我们发送 拉取请求