您想帮助我们使 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 上的远程分支
- 向我们发送一个 拉取请求