Skip to content

Commit

Permalink
Update links to "good first issues" list in index.adoc (#3166)
Browse files Browse the repository at this point in the history
  • Loading branch information
LemongrabThree authored Oct 23, 2024
1 parent 4f2cc1e commit d31e574
Showing 1 changed file with 7 additions and 7 deletions.
14 changes: 7 additions & 7 deletions content/asciidoc-pages/docs/first-timer-support/index.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ Therefore it is quite important for us to provide help to people that want to st
This documentation is still work in progress and some points that are mentioned are ideas for the future that has not been established yet.
====

Adoptium provides several issues that are labeled as https://github.com/orgs/adoptium/projects/[good first issue].
Adoptium provides several issues that are labeled as https://github.com/issues?q=is%3Aopen+is%3Aissue+org%3Aadoptium+archived%3Afalse+label%3A%22good+first+issue%22[good first issue].
All this issues are perfect to start working on an open source project.
The issues provide user friendly descriptions and a lot or helpful links to documentations and tutorials to directly start working on such issue.
Even if you are not really familiar with GitHub in general the issues link to user friendly tutorials that will help users to
Expand All @@ -25,31 +25,31 @@ In GitHub you can find https://github.com/issues?q=org%3AAdoptium+label%3A%22goo

== Templates

We are currently working on an issue template for issues that are labeled as a https://github.com/orgs/adoptium/projects/[good first issue].
We are currently working on an issue template for issues that are labeled as a https://github.com/issues?q=is%3Aopen+is%3Aissue+org%3Aadoptium+archived%3Afalse+label%3A%22good+first+issue%22[good first issue].
https://gist.github.com/hendrikebbers/8e4dec9ddea5e2a420080d1314af025f[The current version of the issue template] and
https://gist.github.com/hendrikebbers/0f9cdd18076343b3bbe5f2d162733b6e[a section about "First timers support" to contributing.md files]
are currently in development.

== Workflow to create good first issues

Whenever you assume that an issue could be a https://github.com/orgs/adoptium/projects/[good first issue] you should label it with the **`good first issue - candidate`** label.
By doing so it can be reviewed and modified to become a https://github.com/orgs/adoptium/projects/[good first issue]
Whenever you assume that an issue could be a https://github.com/issues?q=is%3Aopen+is%3Aissue+org%3Aadoptium+archived%3Afalse+label%3A%22good+first+issue%22[good first issue] you should label it with the **`good first issue - candidate`** label.
By doing so it can be reviewed and modified to become a https://github.com/issues?q=is%3Aopen+is%3Aissue+org%3Aadoptium+archived%3Afalse+label%3A%22good+first+issue%22[good first issue]

In GitHub you can find https://github.com/issues?q=org%3AAdoptium+label%3A%22good+first+issue+-+candidate%22+is%3Aopen[a list of all issues that are labeled by **`good first issue - candidate`**].

All issues that are labeled as **`good first issue - candidate`** should be reviewed and maybe refactored to become https://github.com/orgs/adoptium/projects/[good first issue] labeled issues.
All issues that are labeled as **`good first issue - candidate`** should be reviewed and maybe refactored to become https://github.com/issues?q=is%3Aopen+is%3Aissue+org%3Aadoptium+archived%3Afalse+label%3A%22good+first+issue%22[good first issue] labeled issues.
Here the following rules should be applied:

- The title of the issue must specify the problem
- The description of the issue must be based on https://gist.github.com/hendrikebbers/0f9cdd18076343b3bbe5f2d162733b6e[our **`good first issue`** template]
- The issue should not contain any comments. Comments make it already harder to understand for a newbie.
All relevant information that are in the comments should be added to the description of the issue.
The comments should be removed afterwards.
If this is not possible the best solution is to create a new issue for the https://github.com/orgs/adoptium/projects/[good first issue], link it to the original one, and close the original one.
If this is not possible the best solution is to create a new issue for the https://github.com/issues?q=is%3Aopen+is%3Aissue+org%3Aadoptium+archived%3Afalse+label%3A%22good+first+issue%22[good first issue], link it to the original one, and close the original one.
- When defining the description of the issue it always makes sense to link to documentations or helpful files (maybe even directly to the code)
to help a newcomer to find the right starting point to work on the issue.

Once the issue is refactored and reviewed it should be labeled as https://github.com/orgs/adoptium/projects/[good first issue] and the **`good first issue - candidate`** label should be removed.
Once the issue is refactored and reviewed it should be labeled as https://github.com/issues?q=is%3Aopen+is%3Aissue+org%3Aadoptium+archived%3Afalse+label%3A%22good+first+issue%22[good first issue] and the **`good first issue - candidate`** label should be removed.
Next to this we should label all this issues with **`help wanted`** and **`Hacktoberfest`**.

== Links & Resources
Expand Down

0 comments on commit d31e574

Please sign in to comment.