---
title: "Stability"
url: https://recursiveai.org/oneyaml/csharp/docs/stability/
description: "What a release of oneyaml-csharp promises, and which .NET versions it supports. This is the only place this policy is stated; other pages link here."
version: "1.2.1"
source: https://github.com/recursive-ai-oss/oneyaml-csharp/blob/7818048c4be434333767c47d66176fc626d1da8e/docs/stability.md
---

# Stability

What a release of oneyaml-csharp promises, and which .NET versions it
supports. This is the only place this policy is stated; other pages
link here.

## Versions

From 1.0.0 the packages follow [Semantic Versioning](https://semver.org/).
Within a major version:

- No change breaks code that compiles against the public API of
  `OneYaml`, `OneYaml.Compat.YamlDotNet` or `OneYaml.Compat.SharpYaml`.
  That covers `YamlException` and its `Category`; the text of messages
  is written for people and may change in any release.
- The text that `YamlSerializer.Serialize` writes with default options
  does not change, and neither do the bytes an edit leaves untouched,
  except to fix output that is incorrect. Such a fix is listed in the
  changelog.

The public API and documented behaviour change only in a new major
version. A fix for wrong behaviour can come in a minor or patch release,
including a change to the exception an error path throws. When code
could depend on the old behaviour, the [changelog](https://recursiveai.org/oneyaml/csharp/docs/changelog/)
marks the fix **Breaking**, with what to write instead.

## Supported .NET versions

The packages target `net8.0` and `net10.0`. CI builds and tests both on
Linux, macOS and Windows. Dropping a target framework takes a new major
version.

Microsoft ends support for .NET 8 on 10 November 2026
([.NET support policy](https://dotnet.microsoft.com/en-us/platform/support/policy/dotnet-core)).
The `net8.0` target stays in every 1.x release all the same; it can go
only in a new major version.
After that date .NET 8 itself gets no more security fixes from
Microsoft, so move to .NET 10 when you can.

Security fixes go into the latest release; see [Security](https://github.com/recursive-ai-oss/oneyaml-csharp/blob/7818048c4be434333767c47d66176fc626d1da8e/SECURITY.md).