From c4ce10b26a3a4877c1c0dc7adda003f29d2bec38 Mon Sep 17 00:00:00 2001 From: Clemens Vasters Date: Mon, 8 Jun 2026 10:30:13 +0200 Subject: [PATCH] Editorial: fix title mismatch, phrasing, remove unused RFC4646 - Align introduction with document title: 'Conditional Composition' not 'Conditionals' - Improve awkward sentence structure with semicolon - Remove unused/obsolete RFC4646 from normative references Fixes #1 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- draft-vasters-json-structure-cond-composition.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/draft-vasters-json-structure-cond-composition.md b/draft-vasters-json-structure-cond-composition.md index a800827..deafe5b 100644 --- a/draft-vasters-json-structure-cond-composition.md +++ b/draft-vasters-json-structure-cond-composition.md @@ -28,7 +28,6 @@ author: normative: RFC2119: - RFC4646: RFC8174: JSTRUCT-CORE: title: "JSON Structure Core" @@ -53,7 +52,7 @@ as well as the `if`/`then`/`else` conditional construct. # Introduction {#introduction} -This document specifies JSON Structure Conditionals, an extension to JSON Structure Core {{JSTRUCT-CORE}} that introduces conditional composition constructs for combining multiple schema definitions. In particular, this specification defines the semantics, syntax, and constraints for the keywords `allOf`, `anyOf`, `oneOf`, and `not`, as well as the `if`/`then`/`else` conditional construct. +This document specifies JSON Structure Conditional Composition, an extension to JSON Structure Core {{JSTRUCT-CORE}} that introduces conditional composition constructs for combining multiple schema definitions. In particular, this specification defines the semantics, syntax, and constraints for the keywords `allOf`, `anyOf`, `oneOf`, and `not`, as well as the `if`/`then`/`else` conditional construct. # Terminology and Conventions {#terminology-and-conventions} @@ -67,7 +66,7 @@ The keywords introduced in this document extend the set of keywords allowed for The focus of JSON Structure Core is on data definitions. The conditional composition keywords introduced in this document allow authors to define conditional matching rules that use these fundamental data definitions. -A schema document using these keywords is not a data definition but a rule set for evaluating JSON node instances against schema definitions and lays the groundwork for validation. +A schema document using these keywords is not a data definition; rather, it is a rule set for evaluating JSON node instances against schema definitions and for laying the groundwork for validation. Fundamentally, evaluating a JSON node against a schema involves matching the node against the schema's constraints.