Skip to content

Conversation

@vvolkgang
Copy link
Member

@vvolkgang vvolkgang commented Dec 17, 2025

🎟️ Tracking

PM-29913

📔 Objective

While creating a GitHub Release, our workflow started to fail to retrieve release notes. This happened because the ticket field name changed after the ticket type structure was recently updated.

As part of this PR we're fixing the issue by updating the field name and improving logging in case something similar happens again. Script was non intentionally executed with python3 instead of python, changed it based on internal suggestion without any specific reason other.

Test runs:

⏰ Reminders before review

  • Contributor guidelines followed
  • All formatters and local linters executed and passed
  • Written new unit and / or integration tests where applicable
  • Protected functional changes with optionality (feature flags)
  • Used internationalization (i18n) for all UI strings
  • CI builds passed
  • Communicated to DevOps any deployment requirements
  • Updated any necessary documentation (Confluence, contributing docs) or informed the documentation team

🦮 Reviewer guidelines

  • 👍 (:+1:) or similar for great changes
  • 📝 (:memo:) or ℹ️ (:information_source:) for notes or general info
  • ❓ (:question:) for questions
  • 🤔 (:thinking:) or 💭 (:thought_balloon:) for more open inquiry that's not quite a confirmed issue and could potentially benefit from discussion
  • 🎨 (:art:) for suggestions / improvements
  • ❌ (:x:) or ⚠️ (:warning:) for more significant problems or concerns needing attention
  • 🌱 (:seedling:) or ♻️ (:recycle:) for future improvements or indications of technical debt
  • ⛏ (:pick:) for minor or nitpick changes

@codecov
Copy link

codecov bot commented Dec 17, 2025

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 85.51%. Comparing base (7c929c3) to head (d4ea15b).
⚠️ Report is 6 commits behind head on main.

Additional details and impacted files
@@            Coverage Diff             @@
##             main    #6282      +/-   ##
==========================================
- Coverage   85.53%   85.51%   -0.03%     
==========================================
  Files         761      762       +1     
  Lines       54522    54530       +8     
  Branches     7833     7833              
==========================================
- Hits        46636    46630       -6     
- Misses       5169     5183      +14     
  Partials     2717     2717              

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@github-actions
Copy link
Contributor

github-actions bot commented Dec 17, 2025

Logo
Checkmarx One – Scan Summary & Details47e602f5-ac72-4677-ae4b-883cc6ac1b4b

Great job! No new security vulnerabilities introduced in this pull request

@vvolkgang vvolkgang marked this pull request as ready for review December 17, 2025 22:08
@vvolkgang vvolkgang requested a review from a team as a code owner December 17, 2025 22:08
@claude
Copy link
Contributor

claude bot commented Dec 17, 2025

Claude finished @vvolkgang's task in 1m 52s —— View job


Code Review Complete

The review has identified findings that need attention before merge.

Summary

This PR successfully fixes the Jira field name issue and adds excellent logging improvements. However, there's a documentation-code mismatch that should be corrected.

Key Findings

❌ Critical: Documentation-Code Mismatch

  • README.md examples use customfield_9999
  • Python script uses customfield_10309
  • This creates confusion for developers reading the documentation

❓ Question: Python Command Change

  • Workflow changed from python3 to python
  • Both should work, but was this intentional?

Positive Aspects

✅ Excellent logging improvements with log_customfields_with_content() helper
✅ Proper error handling and graceful degradation
✅ Well-tested with both success and failure scenarios
✅ Clear error messages with consistent prefixing

Recommendation: Fix the documentation mismatch before merge. The field name in README.md should match the actual field used in the script (customfield_10309) or include a clear note explaining the discrepancy.


@vvolkgang vvolkgang marked this pull request as draft December 17, 2025 22:32
@vvolkgang vvolkgang marked this pull request as ready for review December 18, 2025 17:23
echo "Getting product release notes..."
# capture output and exit code so this step continues even if we can't retrieve release notes.
script_exit_code=0
product_release_notes=$(python .github/scripts/jira-get-release-notes/jira_release_notes.py "$_RELEASE_TICKET_ID" "$_JIRA_API_EMAIL" "$_JIRA_API_TOKEN") || script_exit_code=$?
Copy link
Contributor

Choose a reason for hiding this comment

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

Question: Python Command Change

The command changed from python3 to python. Both should work in modern Ubuntu environments, but was this change intentional or incidental?

The test runs show it works correctly, but it's worth documenting the reason if this was a deliberate change.

Copy link
Contributor

Choose a reason for hiding this comment

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

⛏️ I think this is actually a good callout. @vvolkgang I'm assuming this was intentional, so can we mention it in the PR description?

Copy link
Member Author

Choose a reason for hiding this comment

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

Saw something from BRE changing it elsewhere (which I'm not finding now 🤦🏾 ) and followed the lead as it works either way given the versions installed in our runner images, and I didn't have a good enough reason to have it as python3 in the first place other than shenanigans with my local setup at the time.

@mpbw2 mpbw2 added this pull request to the merge queue Dec 19, 2025
Merged via the queue into main with commit 0975144 Dec 19, 2025
42 checks passed
@mpbw2 mpbw2 deleted the vvolkgang/fix-release-notes-jira branch December 19, 2025 21:01
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants