---
title: "oneyaml Rust docs"
url: https://recursiveai.org/oneyaml/rust/docs/
description: "Everything about oneyaml for Rust: getting started, the crate guide, how comments stay attached, moving from serde_yaml, how it compares, and the reference."
version: "1.2.0"
---

# oneyaml Rust docs

Everything about oneyaml for Rust: getting started, the crate guide, how comments stay attached, moving from serde_yaml, how it compares, and the reference.

## Start

- [Getting started](https://recursiveai.org/oneyaml/rust/docs/getting-started/index.md): Add the crate, read YAML into Rust types with serde, write it back, edit a document in place and keep its comments, and apply JSON Patch and merge patches.
- [Crate guide](https://recursiveai.org/oneyaml/rust/docs/guide/index.md): The crate README: quick start, diagnostics, patches and pointers, when not to use oneyaml, untrusted input, merge keys, feature flags and the minimum Rust version.

## Editing

- [Comment attachment](https://recursiveai.org/oneyaml/rust/docs/comment-attachment/index.md): Every comment falls to exactly one rule, decided in this order:

## Migrating

- [From serde_yaml](https://recursiveai.org/oneyaml/rust/docs/migrating-from-serde-yaml/index.md): serde_yaml is archived; serde_yaml_ng and serde_norway are its maintained forks. This guide moves code from any of them to oneyaml. Where it says…

## Choosing

- [Comparison](https://recursiveai.org/oneyaml/rust/docs/comparison/index.md): This page compares oneyaml with the other Rust YAML libraries you are likely to consider. We wrote it, so it is biased: we have tried to be factual, to…
- [Performance](https://recursiveai.org/oneyaml/rust/docs/performance/index.md): What every layer of oneyaml costs against the other Rust YAML libraries, on a fixed, generated corpus of configuration-file shapes. Coming from the chart…

## Reference

- [Conformance](https://recursiveai.org/oneyaml/rust/docs/conformance/index.md): Measured on 2026-10-21 at workspace revision e24c4f8, on the vendored yaml-test-suite (release data-2022-01-17, commit 6e6c296a; 402 cases: 308 valid, 94…
- [Changelog](https://recursiveai.org/oneyaml/rust/docs/changelog/index.md): All notable changes to the published crates (oneyaml, oneyaml-core, oneyaml-syntax). The format follows Keep a Changelog, and versions follow semver.…

## Cookbook

- [All recipes](https://recursiveai.org/oneyaml/rust/cookbook/index.md): 10 short, task-first recipes with complete code.