您想帮助我们让 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 仓库中 readme 文件中的说明进行操作。
在发送更改之前,您必须运行的最重要命令是测试命令
./gradlew test
要成功贡献,所有测试都应该通过!
创建拉取请求
一旦您对更改感到满意
- 将您的更改提交到您的本地分支
- 将您的更改推送到您在 Github 上的远程分支
- 向我们发送拉取请求