From e0858235550d813cc1c5396600c5638b16ce780e Mon Sep 17 00:00:00 2001 From: Mauro Servienti Date: Wed, 4 Dec 2024 12:31:22 +0100 Subject: [PATCH] Document public unsupported APIs (#6921) --- nservicebus/upgrades/release-policy.md | 1 + 1 file changed, 1 insertion(+) diff --git a/nservicebus/upgrades/release-policy.md b/nservicebus/upgrades/release-policy.md index cb4bc4fc8df..1d637217594 100644 --- a/nservicebus/upgrades/release-policy.md +++ b/nservicebus/upgrades/release-policy.md @@ -30,6 +30,7 @@ Given a version number `{major}.{minor}.{patch}`, increment the: * Text in log and exception messages is not considered part of the public API. * Specific instances where following SemVer could hide potential message loss between versions. +* Experimental APIs: Public APIs marked with the [ExperimentalAttribute](https://learn.microsoft.com/en-us/dotnet/csharp/language-reference/proposals/csharp-12.0/experimental-attribute) are considered unsupported and do not adhere to SemVer. Using these APIs requires suppressing compiler warnings, explicitly opting into their unsupported nature. As such, they are subject to change without prior notice or guided obsoletion. ## Backporting important bug fixes