Skip to content

fix: fall back to linking the changelog when it is too long for the release - #124

Merged
skjnldsv merged 1 commit into
mainfrom
fix/changelog-too-long
Sep 16, 2026
Merged

skjnldsv merged 1 commit into
mainfrom
fix/changelog-too-long

Conversation

@skjnldsv

Copy link
Copy Markdown
Collaborator

The changelog step failed on v35.0.0 (run 35026961957):

HTTP 422: Validation Failed
https://api.github.com/repos/nextcloud-releases/server/releases/389498347

GitHub caps a release body at 125,000 characters, and the generated changelog came to 308,810 bytes. Over the limit, the body now points at the attached files instead:

Nextcloud 35.0.0

The changelog is too long to show here. You can find it in the assets below:

There was a second problem behind the same failure, which is why the step order changed. Attach changelog files to release ran after the body was written, so when the body was rejected the job died and the files were never attached either. Both were lost on that run, and what is on the release today was put there by hand. Attaching now happens first, which also means the fallback links point at something that already exists.

The threshold is 120,000 bytes rather than 125,000 characters. Bytes are never fewer than characters, so a changelog full of non-ASCII names trips the fallback slightly early, which is the harmless direction to be wrong in.

Tested the shell locally on both paths: a small changelog passes through unchanged, an oversized one produces exactly the body above, and the boundary behaves (120,000 bytes uses the changelog, 120,001 falls back). Both asset URLs return 200 against the real v35.0.0 release, so the link shape is right.

The workflow itself has not run with this change. The next major release is the real test; a re-dispatch of Generate release changelog for v35.0.0 would exercise the fallback path immediately if you want it proven before then.

👾 This pull request was assisted by Claude Code, commits carry an Assisted-by trailer.

…elease

v35.0.0 failed the changelog step:

  HTTP 422: Validation Failed
  https://api.github.com/repos/nextcloud-releases/server/releases/389498347

GitHub caps a release body at 125,000 characters and the generated changelog
came to 308,810 bytes, so writing it as release notes was rejected. Over the
limit, the body now points at the attached files instead:

  ## Nextcloud 35.0.0

  The changelog is too long to show here. You can find it in the assets below:

  - **[Read it in your browser](.../changelog-v35.0.0.html)**
  - **[Download it as text](.../changelog-v35.0.0.md)**

Attaching the files now happens before the notes are written, so those links
point at something that already exists. It also fixes a second problem with the
same failure: the upload step ran after the body was set, so when the body was
rejected the job died and the changelog files were never attached at all. Both
were lost on that run, and the ones on the release today were put there by
hand.

The threshold is 120,000 bytes rather than 125,000 characters. Bytes are never
fewer than characters, so a changelog with non-ASCII names trips the fallback
slightly early, which is the harmless direction.

Assisted-by: ClaudeCode:claude-opus-5
Signed-off-by: skjnldsv <skjnldsv@protonmail.com>
@skjnldsv skjnldsv added the bug Something isn't working label Sep 16, 2026
@skjnldsv
skjnldsv requested a review from a team September 16, 2026 09:34
@skjnldsv
skjnldsv merged commit dd1922a into main Sep 16, 2026
9 checks passed
@skjnldsv
skjnldsv deleted the fix/changelog-too-long branch September 16, 2026 09:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

bug Something isn't working

Development

Successfully merging this pull request may close these issues.

1 participant