What's Changed

Improvements

• Fail with a descriptive error when path-based rules are used on value-semantic types by @dennisdoomen in #3187
• Significantly speed up BeEquivalentTo for large unordered collections by @dennisdoomen in #3188
• Add ComparingNullCollectionsAsEmpty and ComparingNullStringsAsEmpty options to BeEquivalentTo by @dennisdoomen in #3202
• Include original index in extraneous item failure messages by @dennisdoomen in #3203

Documentation

• Reroute the docs link to Xceed by @dennisdoomen in #3183
• Fix typo in release notes by @jnyrup in #3194
• Fix typos in docs by @jnyrup in #3197

Others

• Bump flatted from 3.4.1 to 3.4.2 in the npm_and_yarn group across 1 directory by @dependabot[bot] in #3184
• Add AI assistant instruction file (agents.md) for Copilot, Claude, and JetBrains Junie by @Copilot in #3176
• Bump smol-toml from 1.6.0 to 1.6.1 in the npm_and_yarn group across 1 directory by @dependabot[bot] in #3185
• Bump the npm_and_yarn group across 1 directory with 2 updates by @dependabot[bot] in #3186
• Bump cspell from 9.7.0 to 10.0.0 by @dependabot[bot] in #3189
• Update nugets by @jnyrup in #3192
• Fixup Qodana issues by @jnyrup in #3193
• Fix Qodana argument separator by @jnyrup in #3195
• Use new Qodana linter option by @jnyrup in #3196
• Fix flaky BeLessThanOrEqualTo execution time test by @Copilot in #3200
• Bump JetBrains/qodana-action from 2025.3 to 2026.1 by @dependabot[bot] in #3201
• Use long for hashCode in ReferentialComparer to avoid overflow by @dennisdoomen in #3204

Full Changelog: 8.9.0...8.10.0

What's Changed

New features

• Add support for Span<T>, ReadOnlySpan<T>, Memory<T> and ReadOnlyMemory<T> by @dennisdoomen in #3172

Improvements

• Allow excluding all properties by type from BeEquivalentTo by @Copilot in #3115
• Clean-up the stack trace when throwing an assertion failure by @dennisdoomen in #3152
• Improve reporting the differences between differently sized collections in BeEquivalentTo by @dennisdoomen in #3133
• Improve reporting the subject when chaining Throw and Which by @dennisdoomen in #3160
• Add HaveMillisecond/NotHaveMillisecond assertion methods for DateTime and DateTimeOffset by @Copilot in #3164
• Add BeEqualTo and NotBeEqualTo as collection assertion aliases by @Copilot in #3166

Fixes

• Fix formatting exception when comparing strings containing braces by @Copilot in #3151

Documentation

• Also mention the global configuration options in the docs. by @dennisdoomen in #3132
• Add xUnit migration tips by @fuguiKz in #3141
• Point the docs to the new site by @dennisdoomen in #3155
• Added missing release notes by @dennisdoomen in #3161
• Fix "an" vs "a" typos by @jnyrup in #3174

Others

• Bump actions/download-artifact from 5 to 6 by @dependabot[bot] in #3116
• Bump cspell from 9.2.1 to 9.2.2 by @dependabot[bot] in #3118
• Bump actions/upload-artifact from 4 to 5 by @dependabot[bot] in #3117
• Add NuGet package attestations using GitHub provenance by @Copilot in #3119
• Bump cspell from 9.2.2 to 9.3.0 by @dependabot[bot] in #3122
• Bump actions/attest-build-provenance from 2 to 3 by @dependabot[bot] in #3121
• fix qodana warnings by @jnyrup in #3123
• Update nuget packages by @jnyrup in #3124
• Bump cspell from 9.3.0 to 9.3.2 by @dependabot[bot] in #3125
• Bump actions/checkout from 5 to 6 by @dependabot[bot] in #3127
• Update to NET 10 SDK by @jnyrup in #3128
• Use == or != when comparing Nullable against constants by @jnyrup in #3129
• Create polyfill for string.Create by @jnyrup in #3130
• Bump cspell from 9.3.2 to 9.4.0 by @dependabot[bot] in #3131
• Bump actions/cache from 4 to 5 by @dependabot[bot] in #3136
• Bump actions/upload-artifact from 5 to 6 by @dependabot[bot] in #3135
• Bump actions/download-artifact from 6 to 7 by @dependabot[bot] in #3134
• Cleanups by @jnyrup in #3137
• Nuget updates by @jnyrup in #3139
• Suppress UnassignedGetOnlyAutoProperty for Node.GetHashCode by @jnyrup in #3138
• Use NonReadonlyMemberInGetHashCode by @jnyrup in #3140
• Bump JetBrains/qodana-action from 2025.2 to 2025.3 by @dependabot[bot] in #3142
• Use compiler-generated paramName parameter by @jnyrup in #3143
• Fix When_concurrently_getting_equality_strategy_it_should_not_throw by @jnyrup in #3144
• Bump cspell from 9.4.0 to 9.6.0 by @dependabot[bot] in #3146
• Bump cspell from 9.6.0 to 9.6.2 by @dependabot[bot] in #3153
• Polyfill string builder appending by @jnyrup in #3156
• Bump cspell from 9.6.2 to 9.6.4 by @dependabot[bot] in #3157
• Bump F# to 8.0 to compile with .NET 11 SDK by @jnyrup in #3159
• Bump cspell from 9.6.4 to 9.7.0 by @dependabot[bot] in #3163
• Bump actions/upload-artifact from 6 to 7 by @dependabot[bot] in #3170
• Bump actions/download-artifact from 7 to 8 by @dependabot[bot] in #3168
• Bump actions/attest-build-provenance from 3 to 4 by @dependabot[bot] in #3169
• Replace attest-build-provenance with attest by @jnyrup in #3171
• Remove UWP.Specs by @jnyrup in #3175

New Contributors

• @Copilot made their first contribution in #3119
• @fuguiKz made their first contribution in #3141

Full Changelog: 8.8.0...8.9.0

What's Changed

Fixes

• Fix a formatting exception when "{}" is used as a dictionary key by @dennisdoomen in #3173
• Ensured WithTracing is safe when used with BeEquivalentTo globally by @dennisdoomen in #3173
• Fix formatting exception when comparing strings containing braces by @dennisdoomen in #3173
• Backport AssertionResultSet fixes from #3100 by @jnyrup in #3173

Building

• Bump F# to 8.0 to compile with .NET 11 SDK by @jnyrup in #3173

Full Changelog: 7.2.1...7.2.2

What's Changed

Fixes

• Prevent a crash while formatting a collection with nested empty collections by @dennisdoomen in #3150

Full Changelog: 7.2.0...7.2.1

What's Changed

New features

• Add support for MSTest4 by @jnyrup in #3111

Improvements

• Allow WithoutMessage when using Should().Throw() and ThrowAsync() by @dennisdoomen in #3100
• Improve reporting of the differences between long strings by @dennisdoomen in #3101
• Allow customizing the equivalency behavior for BeXmlSerializable by @logiclrd in #3107

Documentation

• Add docs for config parameter by @jnyrup in #3104

Others

• Refreshed readme by @dennisdoomen in #3106
• Merge hotfix 8.7.1 back to main by @dennisdoomen in #3109
• Fix release notes by @jnyrup in #3112
• Bump github/codeql-action from 3 to 4 by @dependabot[bot] in #3113

Full Changelog: 8.7.1...8.8.0

What's Changed

Others

• JSON assertions did not properly handle floats, doubles and unsigned … by @dennisdoomen in #3105
• Fixed ambiguity when using Should on a JsonNode derived class ... by @JSkimming in #3102

Full Changelog: 8.7.0...8.7.1

What's Changed

New features

• Added System.Text.Json assertion APIs and BeEquivalentTo support by @dennisdoomen in #3094

Others

• Address a bunch of Qodana issues by @dennisdoomen in #3082
• Bump actions/checkout from 4 to 5 by @dependabot[bot] in #3085
• Bump JetBrains/qodana-action from 2025.1 to 2025.2 by @dependabot[bot] in #3086
• Bump actions/download-artifact from 4 to 5 by @dependabot[bot] in #3087
• Bump cspell from 9.2.0 to 9.2.1 by @dependabot[bot] in #3090
• Bump actions/setup-dotnet from 4 to 5 by @dependabot[bot] in #3092
• Add lock file for nuget packages by @jnyrup in #3084
• Set DisableImplicitNuGetFallbackFolder by @jnyrup in #3095
• Bump Nugets by @jnyrup in #3096
• Revert package locking by @jnyrup in #3098
• Clean-up tests related to exceptions by @dennisdoomen in #3099

Full Changelog: 8.6.0...8.7.0

What's Changed

Improvements

• Add support for inline assertions using Value.ThatMatches and Value.ThatSatisfies by @dennisdoomen in #3076

Others

• Remove Microsoft.SourceLink.GitHub by @SimonCropp in #3072
• Bump cspell from 9.1.3 to 9.1.5 by @dependabot[bot] in #3073
• Added PackageGuard to the build pipeline by @dennisdoomen in #3075
• Bump cspell from 9.1.5 to 9.2.0 by @dependabot[bot] in #3077
• Remove dependencies on Bogus by @jnyrup in #3080
• Update nuget packages by @jnyrup in #3081
• Follow-up to #3076 by @jnyrup in #3079
• Documentation and typo fixes by @jnyrup in #3078

New Contributors

• @SimonCropp made their first contribution in #3072

Full Changelog: 8.5.0...8.6.0

What's Changed

New features

• Extended BeEquivalentTo with support for checking the type of the properties by @dennisdoomen in #3066

Fixes

• Ensured WithTracing is safe when used with BeEquivalentTo globally by @dennisdoomen in #3067

Others

• Revisit the .editorconfig rules by @dennisdoomen in #3063
• Bump cspell from 9.1.1 to 9.1.2 by @dependabot[bot] in #3068
• Use .NET 9 SDK by @jnyrup in #3069
• Bump cspell from 9.1.2 to 9.1.3 by @dependabot[bot] in #3071

Full Changelog: 8.4.0...8.5.0

What's Changed

Improvements

• Allow excluding properties by name anywhere in the graph by @dennisdoomen in #3062
• Added Should().Throw(), ThrowAsync() and ThrowWithinAsync() flavors that don’t require a specific exception type by @Xceed-DelvaJB in #3059

Others

• Bump cspell from 9.0.1 to 9.0.2 by @dependabot in #3050
• Bump JetBrains/qodana-action from 2024.2 to 2025.1 by @dependabot in #3044
• Fix qodana warnings by @jnyrup in #3053
• Add contributor grant by @dennisdoomen in #3055
• Bump cspell from 9.0.2 to 9.1.1 by @dependabot in #3058

New Contributors

• @Xceed-DelvaJB made their first contribution in #3059

Full Changelog: 8.3.0...8.4.0