Skip to content

refactor: reduce release note body size and add cmd - #1527

Merged
SMoraisAnsys merged 16 commits into
mainfrom
refactor/release-note-content
Sep 8, 2026
Merged

refactor: reduce release note body size and add cmd#1527
SMoraisAnsys merged 16 commits into
mainfrom
refactor/release-note-content

Conversation

@SMoraisAnsys

@SMoraisAnsys SMoraisAnsys commented Sep 1, 2026

Copy link
Copy Markdown
Contributor

Refactor the release note body that can be autogenerated to reduce it's size (we have many repos where the number of elements is large. An example is illustrated below with pyansys-geometry's latest release note

image

Also, the content of the release note contains extra information to let users know that they can directly download attestations from the projets repo $REPO_URL/attestations. See #1527 (comment) for the result on a dummy repo.

@SMoraisAnsys

Copy link
Copy Markdown
Contributor Author

We might ant to think about the attestations management strategy for repos...

@SMoraisAnsys

Copy link
Copy Markdown
Contributor Author

Just tried this on a fake repo (only including a fake file with its attestation) and here is the result

image

@SMoraisAnsys
SMoraisAnsys marked this pull request as ready for review September 2, 2026 08:05
@SMoraisAnsys
SMoraisAnsys requested a review from a team as a code owner September 2, 2026 08:05
@SMoraisAnsys
SMoraisAnsys marked this pull request as draft September 2, 2026 08:09
@RobPasMue

Copy link
Copy Markdown
Member

Just tried this on a fake repo (only including a fake file with its attestation) and here is the result

image

I like it ! What if we included one example as part of the release statement. To the first artifact for example.. so that users know how to pass in the <file-path of download artifact>. Otherwise they might start trying dumb things ( I would! 😄 )

Comment thread release-github/action.yml Outdated
Comment thread release-github/action.yml Outdated
@SMoraisAnsys

Copy link
Copy Markdown
Contributor Author

Updating the PR with extra content because the command expects extra flag

image

SMoraisAnsys and others added 3 commits September 2, 2026 11:01
Co-authored-by: Roberto Pastor Muela <37798125+RobPasMue@users.noreply.github.com>
@RobPasMue

Copy link
Copy Markdown
Member

Awesome, thanks @SMoraisAnsys - 958c5c2

@SMoraisAnsys
SMoraisAnsys marked this pull request as ready for review September 2, 2026 15:27
@SMoraisAnsys

SMoraisAnsys commented Sep 2, 2026

Copy link
Copy Markdown
Contributor Author

After some die and retry, here is the latest result. Note that the file is an extra one that I manually attest in my custom release workflow :)

image

@RobPasMue RobPasMue 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.

LGTM! thanks for this enhancement @SMoraisAnsys !

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

🟡 Changes recommended

The new attestation example discovery loop can be unbounded/fragile (word-splitting from $(find ...) and potentially many gh attestation verify calls), which risks slowdowns or rate limiting on large releases.

Once you've addressed the issues Copilot identified, you can request another Copilot review.

Pull request overview

Updates the release-github composite action’s autogenerated release-note content to be shorter on large releases, while still guiding users on verifying artifact attestations and locating downloadable attestation bundles.

Changes:

  • Refactors the “Artifact Attestations” release-notes section to avoid enumerating commands for every artifact and instead provide a concise generic command plus an optional concrete example.
  • Adds a link to the repository’s /attestations page and updates action documentation to recommend attestations: read permission when using attestation features.
  • Adds a changelog fragment documenting the refactor.
File summaries
File Description
release-github/action.yml Shortens autogenerated release-note attestation guidance; adds attestation download link and token-permission guidance; introduces logic to pick an example attested artifact.
doc/source/changelog/1527.miscellaneous.md Adds changelog entry for the release-note refactor.
Review details
  • Files reviewed: 2/2 changed files
  • Comments generated: 2
  • Review effort level: Lite

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread release-github/action.yml
Comment thread release-github/action.yml

@moe-ad moe-ad 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.

LGTM!

I left a minor comment, just for consistency regarding where permission related information should be documented.

Comment thread release-github/action.yml
Comment thread release-github/action.yml Outdated
@SMoraisAnsys
SMoraisAnsys merged commit 15c0550 into main Sep 8, 2026
108 of 109 checks passed
@SMoraisAnsys
SMoraisAnsys deleted the refactor/release-note-content branch September 8, 2026 14:26
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.

6 participants