您想帮助我们使 Groovy™ 编程语言变得更好吗?您可以通过多种方式参与、做出贡献并帮助 Groovy 开发团队使 Groovy 变得更“groovy”?我们非常感谢并欢迎您的贡献,您可以通过以下方式帮助我们:
- 在邮件列表上帮助其他用户或讨论未来的语言方向
- 在Slack上参与讨论 - 此频道未经 Apache 软件基金会认可,由社区中的 Groovy 爱好者运营,用于休闲对话和问答,
- 在我们的错误跟踪器中报告或修复您遇到的问题
- 撰写文档,介绍语言的各个方面或其 API
- 撰写一篇博客文章,介绍某个 Groovy 功能或您的 Groovy 用法
- 创建或评论Groovy 增强提案,其中描述了我们如何对语言进行重大更改
- 改进本网站
- 用更多测试覆盖代码库,以避免未来的回归,
- 当然,还可以通过贡献错误修复或新功能
在邮件列表和论坛上讨论
如果您遇到问题,想讨论新功能,分享有趣的发现等等,那么邮件列表是与 Groovy 开发人员和其他 Groovy 用户开始对话的地方。邮件列表上的讨论会被存档。它是进行所有正式讨论或您想搜索存档的地方。
或者,对于更随意的对话和问答,可以考虑使用Slack频道。(此频道未经 Apache 软件基金会认可;由社区中的 Groovy 爱好者运营。)
报告问题
如果您想搜索现有问题、提出新问题或热衷于修复一些现有问题,那么您应该熟悉 Groovy 的错误跟踪器。
在提交新问题之前,我们建议您阅读我们的报告问题指南
撰写博客文章
Groovy 有很多很棒的功能,有些人从未听说过。为什么不写一篇关于你最喜欢的功能的有趣文章呢?您可以使用自己的博客平台,或者为我们网站博客部分中的新文章创建拉取请求,这些文章会发布到我们自己的博客网站上。
改进文档
Groovy 编程语言的文档有多种形式
- 涵盖语言规范、用户指南、入门等的参考文档。
- 记录 Groovy 代码库类的GroovyDoc API
- Groovy GDK 文档,解释 Groovy 如何丰富 JDK API
- 本网站
要为 Groovy 参考文档做贡献,这篇关于撰写您自己的文章的博客文章将为您提供大量指导。
以上所有内容都存储在我们的代码GitHub 仓库中,因此拥有一个 GitHub 帐户将是理想的。
如果您已经有 Github 帐户,那么为本网站做贡献是相当容易的,因为您可以点击本网站所有页面上看到的“改进此文档”按钮。所以,请不要犹豫,帮助我们改进它,修复拼写错误,修正错误的语言,澄清复杂的章节,添加新材料等。
请查看以下部分,了解有关如何为我们的代码库做出贡献的更多信息。
贡献代码
如果您知道要贡献的领域,那太好了,但如果您正在寻找一些首次贡献,Groovy 开发团队会尝试维护一个可能轻松贡献的问题列表,可以帮助您开启成为 Groovy 提交者的旅程。只需在 Groovy 开发者邮件列表上举手,告诉我们您想处理该问题。
对于更复杂的任务,最好的方法也是提请 Groovy 开发人员注意,这样他们就可以为您提供如何最好地解决特定问题的指导,讨论实现思路以及所提议更改的语义或范围。
克隆代码库
要处理 Groovy 代码库,您应该熟练掌握 git,并且您应该拥有一个 Github 帐户,以便能够创建包含您的更改的 拉取请求。
请fork https://github.com/apache/groovy 并创建您fork的本地克隆,如fork一个仓库中所述。
请确保使用您在 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 上的远程分支
- 向我们发送拉取请求