Skip to content

docs(amdsmi): correct 7.14.0 changelog and move items to 7.15.0#8886

Merged
marifamd merged 6 commits into
developfrom
changelog-714-fix
Jul 21, 2026
Merged

docs(amdsmi): correct 7.14.0 changelog and move items to 7.15.0#8886
marifamd merged 6 commits into
developfrom
changelog-714-fix

Conversation

@marifamd

@marifamd marifamd commented Jul 20, 2026

Copy link
Copy Markdown
Contributor

Motivation

Two problems in the 7.14.0 changelog block:

  1. Three bug-fix bullets from PR fix(amdsmi): process visibility, per-GPU attribution, table alignment #8396 (process visibility, per-GPU attribution, CU%/SDMA table alignment) were filed under 7.14.0, but that PR merged on 2026-07-16 — after the 7.14 release point. The 7.14 release pins rocm-systems at 2b22ab0 (via the therock-7.14 tag, dated 2026-07-09), so those fixes belong in 7.15.0.
  2. A stray (ROCM-21057) JIRA reference in a 7.13.0 headline, which was also missing the Sphinx hard-break trailing spaces.

Technical Details

Changelog (CHANGELOG.md):

  • Add a new ## amd_smi_lib for ROCm 7.15.0 section at the top with a ### Resolved Issues block holding the three PR fix(amdsmi): process visibility, per-GPU attribution, table alignment #8396 process/table-alignment bullets
  • Remove those bullets and the now-redundant ### Fixed heading from 7.14.0 (7.14.0 keeps the Added/Changed/Removed/Resolved-Issues layout of prior releases)
  • Remove the (ROCM-21057) ticket reference from the gfx1151 idle-clock headline and add the trailing double-space for the Sphinx hard break

Skill (.claude/skills/amdsmi-changelog-automation/SKILL.md):

  • Document how to attribute an entry to the correct release: resolve the rocm-systems submodule commit pinned by the matching therock-<ver> TheRock release, then classify each entry's commit with git merge-base --is-ancestor against that pin. Anything after the pin moves to the next release.

JIRA ID

N/A (changelog cleanup)

Test Plan

  • Resolve the 7.14 pin: gh api repos/ROCm/TheRock/git/trees/therock-7.14rocm-systems = 2b22ab0
  • Classify every 7.14 section commit with git merge-base --is-ancestor <commit> 2b22ab0 — only PR fix(amdsmi): process visibility, per-GPU attribution, table alignment #8396 (d7fc3d2) is after the pin
  • grep -nP '^- \*\*.*\*\*[^ ]*$' CHANGELOG.md — no bolded headline missing the trailing double-space
  • grep -nE 'ROCM-[0-9]+|SWDEV-[0-9]+|AILITOOLS-[0-9]+' CHANGELOG.md — no ticket refs remain

Test Result

Submission Checklist

  • Docs-only change; no source or tests affected

@marifamd
marifamd requested a review from a team July 20, 2026 21:41
@therock-pr-bot

therock-pr-bot Bot commented Jul 20, 2026

Copy link
Copy Markdown

✅ All Policy Checks Passed

Check Status Details
🌿 Branch Name ✅ Pass
📝 PR Title/Description ✅ Pass
Forbidden Files ✅ Pass
🧪 Unit Test ✅ Pass PR does not contain code files — Unit Test auto-passed
🚫 Draft PR 🔜 To Be Enabled
🚩 Feature Flag 🔜 To Be Enabled
📊 Code Coverage 🔜 To Be Enabled

🎉 All policy checks passed!

📖 Need help? See the Policy FAQ for details on every check and how to fix failures.

@therock-pr-bot

Copy link
Copy Markdown

🚫 Please fix the failed policies before requesting reviews.

The following policy checks failed:

  • ❌ PR Title/Description

The Not ready to Review label has been added to this PR.
Once all policies pass, the label will be removed automatically.

@marifamd marifamd changed the title docs(amdsmi): fix 7.14.0 changelog section and stray JIRA ref docs(amdsmi): correct 7.14.0 changelog and split post-pin fixes into 7.15.0 Jul 20, 2026
@marifamd marifamd changed the title docs(amdsmi): correct 7.14.0 changelog and split post-pin fixes into 7.15.0 docs(amdsmi): correct 7.14.0 changelog and move items to 7.15.0 Jul 20, 2026
marifamd added 6 commits July 21, 2026 00:26
- Merge the redundant `### Fixed` block into `### Resolved Issues` so the
  7.14.0 release uses the same heading set as every other release
- Remove the `(ROCM-21057)` ticket reference from a 7.13.0 headline and
  add the trailing double-space for the Sphinx hard break

Signed-off-by: Maisam Arif <Maisam.Arif@amd.com>
- Determine the 7.14 release point from the rocm-systems submodule commit
  pinned by the therock-7.14 tag (2b22ab0, 2026-07-09)
- Move the three process-visibility / table-alignment bullets (PR #8396,
  merged 2026-07-16, after the pin) into a new 7.15.0 Resolved Issues
  section; they were incorrectly filed under 7.14.0
- Document the TheRock-pin release-attribution method in the
  amdsmi-changelog-automation skill so entries land in the right release

Signed-off-by: Maisam Arif <Maisam.Arif@amd.com>
- Replace stale [Unreleased]/Fixed references with the repo's real section
  set (Added/Changed/Removed/Optimized/Resolved Issues/Upcoming Changes)
- Route bug fixes to Resolved Issues, deprecations to Upcoming Changes, and
  perf/tooling to Optimized in the required-entry table and example

Signed-off-by: Maisam Arif <Maisam.Arif@amd.com>
- Frame a release's changelog as the diff between two consecutive ROCm
  release pins (PREV_PIN..CURR_PIN) instead of hard-coding 7.14/7.15
- Resolve both bracketing pins dynamically; fall back to origin/develop as
  the upper bound while the current release is untagged
- Keep the merge-base --is-ancestor check for classifying PR-history
  commits; drop the 'iff' wording

Signed-off-by: Maisam Arif <Maisam.Arif@amd.com>
Bound each section by its own TheRock pin (drop the patch component) and
check both range bounds so entries merged after a release's pin are flagged
TOO NEW, not silently passed. Make pin() tolerate lookup errors, auto-derive
the section line range, add a heading-taxonomy check, and cut the redundant
review-checklist and severity tables. 166 -> 101 lines.

Signed-off-by: Maisam Arif <Maisam.Arif@amd.com>
The IFoE/UALoE lazy-init fix merged to develop after the 7.14.0 pin, so its
changelog entry landed under 7.14.0. Move it into the 7.15.0 Resolved Issues
section where post-pin fixes belong.

Signed-off-by: Maisam Arif <Maisam.Arif@amd.com>
@marifamd
marifamd force-pushed the changelog-714-fix branch from 4a04d0f to 7526436 Compare July 21, 2026 05:28
@marifamd
marifamd merged commit 731e999 into develop Jul 21, 2026
22 of 23 checks passed
@marifamd
marifamd deleted the changelog-714-fix branch July 21, 2026 14:20
cmcknigh pushed a commit that referenced this pull request Jul 22, 2026
- Move the IFoE/UALoE lazy-init fix entry from 7.14.0 to the 7.15.0
  Resolved Issues section, since it merged after the 7.14.0 pin
- Keep 7.14.0 limited to entries that shipped in that release

---------

Signed-off-by: Maisam Arif <Maisam.Arif@amd.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants