Skip to content

Switch release versioning to vYYYY.MM.PATCH (CalVer) - #36

Merged
MikeWills merged 1 commit into
masterfrom
chore/calver-versioning
Sep 13, 2026
Merged

MikeWills merged 1 commit into
masterfrom
chore/calver-versioning

Conversation

@MikeWills

Copy link
Copy Markdown
Owner

Summary

Release tags become vYYYY.MM.PATCH — v2026.09.0, v2026.09.1, then v2026.10.0. PATCH restarts at 0 each month; the month keeps its leading zero in the tag. v0.4.0 stays as the last SemVer tag.

No code change required. UpdateCheckService compares System.Version, which is numeric per component: 2026.09.0 parses as 2026.9.0, which is newer than every 0.x.y tag and orders correctly month-to-month. Verified locally that dotnet build -p:Version=2026.09.0 succeeds with assembly version 2026.9.0.0 (informational version keeps 2026.09.0). The only visible side effect: the startup log line reads v2026.9.0 (no leading zero).

Changes:

  • CONTRIBUTING.md — new "Version scheme" section + updated tag examples
  • CLAUDE.md — pitfall entry so future work doesn't cut SemVer tags
  • NwsAlertBot.csproj, release.yml, scripts/update.ps1, README.md — comment/example updates (v1.2.3 → v2026.09.0)
  • UpdateCheckServiceTests — new test pinning CalVer ordering and CalVer > legacy SemVer
  • CHANGELOG.md

Test plan

  • dotnet test — 136 pass
  • dotnet build -p:Version=2026.09.0 locally → assembly 2026.9.0.0
  • Next release cut as v2026.09.0 and release.yml publishes normally

🤖 Generated with Claude Code

https://claude.ai/code/session_01UokAERat9fVzmcmsfJzsJF

Tags are now v2026.09.0, v2026.09.1, v2026.10.0 ... PATCH restarts at 0 each
month; the month keeps its leading zero in the tag. No code change needed:
System.Version compares numerically (2026.09.0 == 2026.9.0 > 0.4.0), verified
locally that -p:Version=2026.09.0 builds as assembly version 2026.9.0.0, and a
new test pins the ordering. Docs/examples updated; v0.4.0 stays the last
SemVer tag.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01UokAERat9fVzmcmsfJzsJF
@MikeWills
MikeWills merged commit a829437 into master Sep 13, 2026
1 check passed
@MikeWills
MikeWills deleted the chore/calver-versioning branch September 13, 2026 01:30
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