Fix broken workflow examples and stale action version comments
@miroslavpojer đang làm issue này rồi.
Từ ngày 19/11/2026.
Đánh giá
Issue này chưa được đánh giá.
Mô tả
Motivation
These problems were found while reviewing the changes for #355. They already exist on master and are outside the scope of #355. Two of them break the workflows users copy from our documentation.
Observed problems
1. README release example reads an output that does not exist
The "Manual Release Dispatch" example passes ${{ steps.notes.outputs.release_notes }} to the release body, but the action's output is named release-notes (see outputs: in action.yml). The expression evaluates to an empty string, so a workflow copied from the README creates a draft release with an empty body.
2. examples/release_draft.yml does not run as written
needs: check-tagrefers to a job that is not defined in the file, so GitHub rejects the workflow.skip-release-notes-label: 'no RN'is not an input of this action; the input isskip-release-notes-labels. GitHub only warns about the unexpected input, so the skip label is silently ignored.
https://github.com/AbsaOSS/generate-release-notes/blob/ce11fa9445e7c12eed4cdd2004bcf95929a3c755/examples/release_draft.yml#L14
https://github.com/AbsaOSS/generate-release-notes/blob/ce11fa9445e7c12eed4cdd2004bcf95929a3c755/examples/release_draft.yml#L64
3. Version comments on pinned actions are out of date
The workflows pin actions by commit SHA, with a comment naming the version. Two of those comments no longer match the commit they annotate:
| Pin | Comment says | Commit is actually | Occurrences |
|---|---|---|---|
actions/checkout@3d3c42e5… |
# v4 |
v7.0.1 |
7 (plus 1 without a comment) |
actions/setup-python@6d4fd22b… |
# v5 |
v7.1.0 |
7 (plus 1 without a comment) |
Reviewers reading the workflows, including Dependabot PRs, see the wrong major version.
4. Unused cache attribute in ActionInputs
ActionInputs._row_format_link_pr is declared and reset in reset_caches(), but get_row_format_link_pr() never reads or stores it, unlike the other row-format getters.
https://github.com/AbsaOSS/generate-release-notes/blob/ce11fa9445e7c12eed4cdd2004bcf95929a3c755/release_notes_generator/action_inputs.py#L83
https://github.com/AbsaOSS/generate-release-notes/blob/ce11fa9445e7c12eed4cdd2004bcf95929a3c755/release_notes_generator/action_inputs.py#L568
Proposed changes
- README: change the release body to
${{ steps.notes.outputs.release-notes }}. examples/release_draft.yml: removeneeds: check-tag(or add the missing job), and rename the input toskip-release-notes-labels.- Workflows: update the version comments to the versions the SHAs point to (
# v7.0.1for checkout,# v7.1.0for setup-python) and add the missing ones. ActionInputs: remove_row_format_link_pr, or makeget_row_format_link_pr()cache its value like the other row-format getters.
Acceptance criteria
- A workflow copied from the README "Manual Release Dispatch" example creates a draft release whose body contains the generated notes.
examples/release_draft.ymlpasses workflow validation (for exampleactionlint) and uses only inputs defined inaction.yml.- Every SHA-pinned action in
.github/workflows/has a version comment that matches the tag its SHA points to. ActionInputshas no unused cache attributes, and unit tests still pass.
- Ngôn ngữ chính
- Python
- Star
- 12
- Fork
- 0
- Merge trung bình
- 1 phút
- Pull request đã merge (30 ngày)
- 6
Chuẩn bị môi trường
- Không có Dockerfile hay tệp Docker Compose
- Có mẫu pull request
- Đọc hướng dẫn đóng góp
Bắt đầu từ đâu
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Issue khác của AbsaOSS/generate-release-notes
-
bug
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 66/100
-
enhancement
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 70/100
-
bug
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 58/100
-
In newly created draft hashes are not linked.Có thể đã có người làm @bfs2021 đã nhận hôm nay. Đang mởbug
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 35/100
-
Release v1.4.0Có thể đã có người làm @miroslavpojer đã nhận 1 ngày trước. Đang mởepic
AbsaOSS/generate-release-notes#358 · 1 người được giao ·
Tất cả issue của AbsaOSS/generate-release-notes
Issue tương tự
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 78/100
abetlen/llama-cpp-python#2424 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Bug IronPython Python 3
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 72/100
pyrevitlabs/pyRevit#4184 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
CLAW (Agents & Orchestration)Đang mở
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 74/100
jqueryscript/awesome-claude-code#1009 ·
-
tests
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 66/100
Maintainer thường phản hồi trong vòng 3 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 72/100
Maintainer thường phản hồi trong vòng 1 ngày