Skip to content

docs: Add CHANGELOG.md - #252

Merged
hrak merged 1 commit into
masterfrom
add_changelog
Sep 21, 2026
Merged

hrak merged 1 commit into
masterfrom
add_changelog

Conversation

@hrak

@hrak hrak commented Sep 21, 2026

Copy link
Copy Markdown
Member

Issue #, if available: n/a

Description of changes:

Adds a CHANGELOG.md at the repository root covering the relevant changes of every driver release from v0.1.0 (2023-06-13) through v0.14.0, newest-first, in Keep a Changelog format with a compare link per release.

How the entries were built:

  • Substance comes from the non-merge commit subjects between consecutive vX.Y.Z tags, rather than the auto-generated GitHub release notes (which are mostly Dependabot noise).
  • Kubernetes library, CSI spec and Go versions per release were read from git show <tag>:go.mod, so the version claims are grounded rather than inferred.
  • Routine CI, linter and transitive dependency bumps are omitted. Kubernetes library bumps are kept, since they determine which Kubernetes releases the driver is built and tested against.

A few deliberate choices, flagged for review:

  • The v0.14.0 section is dated 2026-09-21 and is not yet tagged. It covers what is currently on master since v0.13.0. Its compare link will 404 until the tag exists, so this should merge before v0.14.0 is cut — otherwise the tagged release will not contain its own changelog entry.
  • Kubernetes support levels are described inline per release rather than as a compatibility matrix, matching the earlier decision not to introduce a support matrix in the README or chart.
  • The v0.1.0-rc.1 pre-release tag is excluded.
  • The header notes that the Helm chart is versioned separately under cloudstack-csi-* tags and that its version is bumped after the driver release it ships, so the two do not line up one-to-one.

The v0.12.1 entry records that cloudstack-go was rolled back to v2.17.1 because newer releases are not compatible with the older CloudStack version the driver runs against — context supplied by @hrak, since the commit message itself gives no reason.

Testing performed:

  • Verified all 21 releases have both a ## [vX.Y.Z] section and a matching link definition, and that no Unreleased references remain.
  • Docs-only change; no code, build or chart files touched.

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

🤖 Generated with Claude Code

Document the relevant changes of every driver release from v0.1.0 through
v0.14.0, in Keep a Changelog format with compare links per release.

Entries are derived from the commit history between release tags, with
the Kubernetes library, CSI spec and Go versions read from go.mod at each
tag. Routine CI, linter and transitive dependency bumps are left out;
Kubernetes library bumps are kept, since they determine which Kubernetes
releases the driver is built and tested against.

The Helm chart keeps its own cloudstack-csi-* tags and is noted as
separately versioned.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@hrak
hrak merged commit 23e4414 into master Sep 21, 2026
2 checks passed
@hrak
hrak deleted the add_changelog branch September 21, 2026 16:08
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