Skip to content

Conversation

@dunkOnIT
Copy link

No description provided.

@dunkOnIT dunkOnIT marked this pull request as ready for review November 21, 2025 15:32
@dunkOnIT dunkOnIT changed the title WCIF v2 & Versioning Policy WCIF v1.1 & Versioning Policy Dec 1, 2025
specification.md Outdated
Comment on lines 8 to 10
- Status: Latest
- Next Status: Stable
- Status Advancement Date: 2025-12-07
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't understand the real-world implications of this. What does "advancement from Latest to Stable" practically mean? And why did you pick the 7th of December?

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Date change was completely arbitrary (and should obviously now be updated).

Latest and Stable are defined in the versioning policy - basically, Latest needs to be specifically requested, and Stable is the version returned by default.

This does need some tweaking now that we aren't including the H2H changes, and we aren't doing a major version update, though

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Decided to just make this version Stable straight away, given that it's a minor increment

- **Major**: increments upon _breaking changes_ - ie, changes that would cause errors in implementations relying on the current latest version
- Removing or renaming a field
- Changing a field’s type, or removing previously-available enum values
- Adding new field(s)/values which cannot be mapped to previous values
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"adding values which cannot be mapped to previous values" sounds like exactly the thing we're doing with Bo5 though?

So you're doing a minor release, but it contains something which per this description should be a major release. I am confused.

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Tried to add some clarity around that point - let me know if it makes sense

Copy link
Member

@gregorbg gregorbg left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Advancing to 1.1 straight away means that we would need to also touch code in the monolith, because it currently sends 1.0 hard-coded...

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.

3 participants