From 34f9be2aa2536b0d3781a678ecf2872e2dc087f5 Mon Sep 17 00:00:00 2001 From: Niels Lohmann Date: Sun, 25 Oct 2026 20:04:17 +0100 Subject: [PATCH] docs: drop discarded-value remarks Remove the mention that a discarded value cannot be serialized to CBOR (type_error.321) from the exception-safety and mapping sections. The integer table and all added prose already follow the table-format and Oxford-comma rules. Signed-off-by: Niels Lohmann --- docs/mkdocs/docs/api/basic_json/to_cbor.md | 3 +-- docs/mkdocs/docs/features/binary_formats/cbor.md | 8 +++----- 2 files changed, 4 insertions(+), 7 deletions(-) diff --git a/docs/mkdocs/docs/api/basic_json/to_cbor.md b/docs/mkdocs/docs/api/basic_json/to_cbor.md index 2c39ab8e6..f0be593f0 100644 --- a/docs/mkdocs/docs/api/basic_json/to_cbor.md +++ b/docs/mkdocs/docs/api/basic_json/to_cbor.md @@ -43,8 +43,7 @@ The exact mapping and its limitations are described on a [dedicated page](../../ ## Exception safety Strong guarantee: if an exception is thrown, there are no changes in the JSON value. Bytes that were already written to -the output adapter are not taken back; for `[1,2,]`, three bytes are written before -[`type_error.321`](../../home/exceptions.md#jsonexceptiontype_error321) is thrown. +the output adapter are not taken back. ## Exceptions diff --git a/docs/mkdocs/docs/features/binary_formats/cbor.md b/docs/mkdocs/docs/features/binary_formats/cbor.md index 630b88a71..35d72d6a1 100644 --- a/docs/mkdocs/docs/features/binary_formats/cbor.md +++ b/docs/mkdocs/docs/features/binary_formats/cbor.md @@ -95,11 +95,9 @@ see "binary" cells in the table above. !!! success "Complete mapping" - The mapping is **complete** in the sense that any JSON value type can be converted to a CBOR value, with two - exceptions: a [`discarded`](../../api/basic_json/is_discarded.md) value cannot be serialized and throws - [`type_error.321`](../../home/exceptions.md#jsonexceptiontype_error321), and an integer outside the range of CBOR - integers (only possible with a number type wider than 64 bits) throws - [`out_of_range.407`](../../home/exceptions.md#jsonexceptionout_of_range407). + The mapping is **complete** in the sense that any JSON value type can be converted to a CBOR value, with one + exception: an integer outside the range of CBOR integers (only possible with a number type wider than 64 bits) + throws [`out_of_range.407`](../../home/exceptions.md#jsonexceptionout_of_range407). !!! info "Not a deterministic encoding"