Skip to content

Open RavenDB.Client version range for broader compatibility#726

Merged
danielmarbach merged 11 commits intomasterfrom
ravendb-client-upgrade
Sep 6, 2025
Merged

Open RavenDB.Client version range for broader compatibility#726
danielmarbach merged 11 commits intomasterfrom
ravendb-client-upgrade

Conversation

@danielmarbach
Copy link
Copy Markdown
Contributor

@danielmarbach danielmarbach commented Sep 5, 2025

According to RavenDB backward compatibility issues on the client API surface is something they really care about.

For example, see the client breaking changes here for 7.1:
https://docs.ravendb.net/7.1/migration/client-api/client-breaking-changes/
The likelihood that you'll run into any of those is very low

They recommended us to target the LTS version as a minimum version using the Minimum version, inclusive syntax in the nuget ranges.

To play slightly extra safe, we are capping the range to currently supported LTS and STS.

Should one day a version be released that is incompatible with the persister, we can release a patch that locks into the last known configuration and release another minor version bringing in the version that has breaking changes as the minimum required version.

Customers using the persistence that do not take an explicit dependency on RavenDB.Client will get the minimum required LTS version by default. This seems to be a reasonable tradeoff between allowing a broader range of client versions and unlocking people leveraging features of newer server versions that remain backward compatible.

@danielmarbach danielmarbach changed the title Ravendb client upgrade Open RavenDB.Client version range for broader compatibility Sep 5, 2025
@danielmarbach danielmarbach marked this pull request as ready for review September 5, 2025 14:13
@DharmishthaVPatel DharmishthaVPatel added this to the 5.1.0 milestone Sep 5, 2025
@DharmishthaVPatel
Copy link
Copy Markdown
Contributor

Changes look good to me; my only concern is whether we're adding extra load by running the same set of tests with a different version. Only one test case can be verified.

@danielmarbach danielmarbach merged commit e179b8f into master Sep 6, 2025
4 checks passed
@danielmarbach danielmarbach deleted the ravendb-client-upgrade branch September 6, 2025 08:12
@soujay
Copy link
Copy Markdown
Contributor

soujay commented Sep 6, 2025

LGTM - approved

DharmishthaVPatel pushed a commit that referenced this pull request Sep 8, 2025
* Have a latest project with renovate configured

* Try latest action

* Deliberately use something lower for now

* Correct format

* Try this

* Move

* Cluster wide latest

* Cap upper bound

* Indent

* Stable action

* Upgrade to latest for now

---------

Co-authored-by: Daniel Marbach <danielmarbach@users.noreply.github.com>
@DharmishthaVPatel DharmishthaVPatel removed this from the 5.1.0 milestone Sep 9, 2025
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