Skip to content

docs: document the NuGet release process in AGENTS.md - #665

Merged
rexm merged 2 commits into
masterfrom
docs/agents-release-process
Aug 7, 2026
Merged

docs: document the NuGet release process in AGENTS.md#665
rexm merged 2 commits into
masterfrom
docs/agents-release-process

Conversation

@rexm

@rexm rexm commented Aug 7, 2026

Copy link
Copy Markdown
Member

Summary

While cutting the upcoming 2.4.1 patch release (fixing #660 and #661), had to read through .github/workflows/release.yml and prior release history to reconstruct how releases actually work here. Recording it in AGENTS.md so that's a one-time cost instead of a recurring one.

Key facts captured:

  • The version comes entirely from the published GitHub Release's tag name (github.event.release.tag_name) — there's no version to bump in any .csproj/Directory.Build.props.
  • Only the release: published event triggers the workflow — a tag alone, or a draft release, does nothing.
  • Tag format has no v prefix (2.4.0, not v2.4.0).
  • Publishing to NuGet is irreversible, so the merge/CI state should be confirmed before creating the release.

Test plan

N/A — documentation only.

🤖 Generated with Claude Code

rexm and others added 2 commits August 6, 2026 20:51
Derived from reading .github/workflows/release.yml and gh release history
while cutting 2.4.1 — record it so it doesn't need re-deriving each time:
the version comes entirely from the published GitHub Release's tag name
(no file to bump), only a *published* Release triggers the workflow, and
publishing is irreversible so the merge/CI state should be confirmed first.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@rexm
rexm enabled auto-merge August 7, 2026 01:10
@sonarqubecloud

sonarqubecloud Bot commented Aug 7, 2026

Copy link
Copy Markdown

@rexm
rexm merged commit b7098f9 into master Aug 7, 2026
7 checks passed
@rexm
rexm deleted the docs/agents-release-process branch August 7, 2026 01:16
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.

1 participant