Skip to content

Adopt Semantic Versioning and add a changelog - #9

Merged
anderslindho merged 1 commit into
masterfrom
docs/adopt-semantic-versioning
Jul 31, 2026
Merged

Adopt Semantic Versioning and add a changelog#9
anderslindho merged 1 commit into
masterfrom
docs/adopt-semantic-versioning

Conversation

@anderslindho

Copy link
Copy Markdown
Contributor

This PR proposes adopting Semantic Versioning for future recCaster releases. It adds a CHANGELOG.md based on Keep a Changelog and establishes an Unreleased section for upcoming changes.

Historical release entries are intentionally deferred to the tag migration discussed in #3, where the corresponding recCaster contents can first be verified.

Closes #8

Give future standalone releases a defined versioning scheme and durable
release history.
@shroffk

shroffk commented Jul 30, 2026

Copy link
Copy Markdown
Contributor

@ralphlange does this match with other (hopefully most) epics modules?

@ralphlange

Copy link
Copy Markdown

Not that it matters (we're Phoebus and services!), but: it's in line, yes.
(I was not aware of Keep a Changelog - interesting.)

@anderslindho

Copy link
Copy Markdown
Contributor Author

I'd push back a little bit on that yes, @ralphlange. Many EPICS projects use implicit patch 0s, which is not allowed per semver. Some also use disallowed separators (hyphens over periods), and I am not sure they all fully respect the semver significance of MAJOR.MINOR.PATCH. Plus EPICS base itself does not follow semver (the leading "protocol" digit). But it's close enough.

@anderslindho
anderslindho merged commit 538e743 into master Jul 31, 2026
86 of 90 checks passed
@ralphlange

Copy link
Copy Markdown

Many EPICS projects are much older than semver. Some old habits (like the stupid RX-Y notation) never die.

Newer projects try to follow, and it is seen as a valuable standard to follow within the Core devs. I keep my yes.

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.

Define a versioning scheme

4 participants