Documentation
Eclipse Adoptium® 新手支持

在 Adoptium,我们要帮助人们进入开源、Java 和 Java 社区。 因此,为想要开始从事开源工作的人提供帮助对我们来说非常重要。

本文档仍在进行中,提到的一些点是未来的想法,尚未建立。

Adoptium 提供了一些标记为 good first issue 的问题(issues)。 所有这些问题都非常适合开始在一个开源项目上工作。 这些问题提供了用户友好的描述,以及许多指向文档和教程的有用链接,以便直接开始处理此类问题。 即使你不太熟悉 GitHub,这些问题也会链接到用户友好的教程,帮助用户 理解 fork 和 pull request 的工作流程。

在 GitHub 上,你可以找到 所有标记为 good first issue 的问题列表

模板

我们目前正在为标记为 good first issue 的问题制定问题模板。 问题模板的当前版本关于 contributing.md 文件中“新手支持”的一节 目前正在开发中。

创建 good first issues 的工作流程

每当你认为一个问题可能是一个 good first issue 时,你应该给它加上 good first issue - candidate 标签。 这样做可以对其进行审查和修改,使其成为一个 good first issue

所有标记为 good first issue - candidate 的问题都应该被审查,也许还需要重构,以成为标记为 good first issue 的问题。 这里应适用以下规则:

  • 问题的标题必须说明问题

  • 问题的描述必须基于 我们的 good first issue 模板

  • 问题不应包含任何评论。评论会让新手更难理解。 评论中的所有相关信息都应添加到问题的描述中。 评论应随后删除。 如果这不可能,最好的解决方案是为 good first issue 创建一个新问题,将其链接到原始问题,并关闭原始问题。

  • 在定义问题的描述时,链接到文档或有用的文件(甚至可能直接链接到代码)总是有意义的, 以帮助新人找到处理问题的正确起点。

一旦问题被重构和审查,它应该被标记为 good first issue,并且 good first issue - candidate 标签应该被移除。 除此之外,我们应该用 help wantedHacktoberfest 标记所有这些问题。

文档作者
MBoegershendrikebbersgdamstellisonNdacyayisenga-droid
edit icon

帮助我们完善这些文档!

所有 Adoptium 文档均为开源。发现错误或不清楚的内容?

gradient overlay mobile
message icon

Connect with the community

Join our Slack channel to discuss work and reach out to project maintainers.
Eclipse Adoptium® 新手支持 | Adoptium