Skip to content

#2276: Add Backlog section documenting how to find a new story - #2290

Merged
hohwille merged 6 commits into
devonfw:mainfrom
krystynaShatkovska:feature/issue-2276
Aug 13, 2026
Merged

#2276: Add Backlog section documenting how to find a new story#2290
hohwille merged 6 commits into
devonfw:mainfrom
krystynaShatkovska:feature/issue-2276

Conversation

@krystynaShatkovska

@krystynaShatkovska krystynaShatkovska commented Aug 7, 2026

Copy link
Copy Markdown
Contributor

This PR fixes #2276

Implemented changes:

  • Added a new "Backlog" section to documentation/contributing/issue.adoc with a step-by-step guide on how to find and pick a new story from the project backlog — including the
    issue query link, explanation of ready-to-implement and good-first-issue labels, consideration of Priority/Size for experienced contributors, and a reminder to self-assign
    before starting work

Testing instructions

  1. Open documentation/contributing/issue.adoc and verify that the new == Backlog section appears before == Working on an Issue
  2. Check that the linked issue query URL opens the correct filtered issue list:
    https://github.com/devonfw/IDEasy/issues?q=is%3Aissue%20state%3Aopen%20no%3Aassignee%20label%3Aready-to-implement
  3. Verify that the cross-reference link to project-board.adoc resolves correctly
  4. Confirm that no content from the existing "Working on an Issue" section was lost or broken

Checklist for this PR

Make sure everything is checked before merging this PR. For further info please also see
our DoD.

  • When running mvn clean test locally all tests pass and build is successful
  • PR title is of the form #«issue-id»: «brief summary» (e.g. Bump jackson.version from 2.18.0 to 2.18.2 #921: fixed setup.bat). If no issue ID exists, title only.
  • PR top-level comment summarizes what has been done and contains link to addressed issue(s)
  • PR and issue(s) have suitable labels
  • Issue is set to In Progress and assigned to you or there is no issue (might happen for very small PRs)
  • You followed all coding conventions
  • You have added the issue implemented by your PR in CHANGELOG.adoc unless issue is labeled
    with internal
  • You have formulated clear instructions on how to test your contribution under "Testing instructions"

Notes:

  • I removed the "Checklist for tool commandlets" section since this PR doesn't add a commandlet (as instructed)
  • Don't check the boxes yet — the instructions say to check them after the PR is created
  • The PR title should be: Create documentation how to find story from Backlog #2276: Add Backlog section documenting how to find a new story

@github-project-automation github-project-automation Bot moved this to 🆕 New in IDEasy board Aug 7, 2026
@krystynaShatkovska krystynaShatkovska self-assigned this Aug 7, 2026
@krystynaShatkovska krystynaShatkovska added documentation Improvements or additions to documentation enhancement New feature or request labels Aug 7, 2026
@krystynaShatkovska krystynaShatkovska moved this from 🆕 New to Team Review in IDEasy board Aug 7, 2026
@krystynaShatkovska krystynaShatkovska moved this from Team Review to 🏗 In progress in IDEasy board Aug 7, 2026
@coveralls

coveralls commented Aug 7, 2026

Copy link
Copy Markdown
Collaborator

Coverage Report for CI Build 31683252955

Coverage remained the same at 72.887%

Details

  • Coverage remained the same as the base build.
  • Patch coverage: No coverable lines changed in this PR.
  • No coverage regressions found.

Uncovered Changes

No uncovered changes found.

Coverage Regressions

No coverage regressions found.


Coverage Stats

Coverage Status
Relevant Lines: 17548
Covered Lines: 13340
Line Coverage: 76.02%
Relevant Branches: 7757
Covered Branches: 5104
Branch Coverage: 65.8%
Branches in Coverage %: Yes
Coverage Strength: 3.23 hits per line

💛 - Coveralls

@krystynaShatkovska krystynaShatkovska moved this from 🏗 In progress to Team Review in IDEasy board Aug 7, 2026

@Hiepiscus Hiepiscus left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@krystynaShatkovska Looks good to me. The new section clearly explains how to find a suitable issue from the backlog and covers all points from the issue description. One thing I noticed, I think there is a typo in the rendered URL, so the project board link does not resolve correctly.

Comment thread documentation/contributing/issue.adoc Outdated
@Hiepiscus Hiepiscus moved this from Team Review to 👀 In review in IDEasy board Aug 7, 2026
Update documentation/contributing/issue.adoc

Co-authored-by: Hiepiscus <le-hiep.ha@capgemini.com>
@krystynaShatkovska krystynaShatkovska added the QA approved Label a PR that has been re-testet via nightly SNAPSHOT after merge and commented. label Aug 10, 2026

@hohwille hohwille left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@krystynaShatkovska thank you for your PR. This is a great improvement. 👍
I only have marginal nice-to-have suggestions for you.

Comment thread documentation/contributing/issue.adoc Outdated
Comment thread documentation/contributing/issue.adoc Outdated
Co-authored-by: Jörg Hohwiller <hohwille@users.noreply.github.com>
@krystynaShatkovska krystynaShatkovska self-assigned this Aug 12, 2026
@hohwille
hohwille merged commit 31dabbf into devonfw:main Aug 13, 2026
4 checks passed
@github-project-automation github-project-automation Bot moved this from 👀 In review to ✅ Done in IDEasy board Aug 13, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation enhancement New feature or request QA approved Label a PR that has been re-testet via nightly SNAPSHOT after merge and commented.

Projects

Status: ✅ Done

Development

Successfully merging this pull request may close these issues.

Create documentation how to find story from Backlog

4 participants