From 5d495886dc1f4ce39f90bcb7b04c16860495b3ec Mon Sep 17 00:00:00 2001 From: "A.J. Stein" Date: Tue, 5 Sep 2023 14:02:36 -0400 Subject: [PATCH] Edit target to targeting set, per PR review. Co-authored-by: Wendell Piez --- website/content/specification/syntax/constraints.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/website/content/specification/syntax/constraints.md b/website/content/specification/syntax/constraints.md index e16d7f51..7e97430d 100644 --- a/website/content/specification/syntax/constraints.md +++ b/website/content/specification/syntax/constraints.md @@ -18,7 +18,7 @@ The `allowed-values` constraint is a kind of Metaschema constraint that restrict Metaschema processors MUST process `allowed-values` enumerations. -The `@target` attribute of an `` constraint is used to determine the specific content values the constraint applies to. By evaluating the `@target`, it is possible to identify the *target set* of `` constraints targeting a given value. +The `@target` attribute of an `` constraint is used to determine the specific content values the constraint applies to. For any given value or node, it is possible to identify the *targeting set* of `` constraints based on their `@target` attributes. If the value or node among is among those being targeted, the constraint is a member of its targeting set. The *source* of each allowed `` constraint in the *target set* is identified as one of the following sources: @@ -27,7 +27,7 @@ The *source* of each allowed `` constraint in the *target set* i The *target set* of `` constraints is verified for correctness using the `@extension` attribute on each set member. -Once the *target set* of `` constraints is validated, the `@allow-other` attribute is used to determine the *expected value set* for a given content value. +Once the *targeting set* of `` constraints is determined, their respective `@allow-other` attributes are used to determine the *expected value set* for a given content value. The following subsections detail the processing requirements for the `@extension` and `@allow-other` attributes. @@ -64,13 +64,13 @@ For each `` constraint, the `@allow-other` attribute MUST be one - **`yes`:** Identifies the *expected value set* as *open*, as long as no other `` constraint in the *target set* has `@allow-other="no"` declared explicitly or implicitly. - **`no`:** (default) Identifies the *expected value set* as *closed*. **This is the implicit default value if no `@allow-other` is provided.** -One of the following requirements MUST apply when processing the a value's *target set* to determine the *expected value set*. +One of the following requirements MUST apply when processing a value's *targeting set* of `` constraints to determine the *expected value set*. 1. One `` constraint in the *target set* MUST have the `@allow-other` attribute value `no`. The *expected value set* is *closed*. - The actual value MUST match one of the enumerated values declared on any of the `` constraints in the *target set**target set*. An error MUST be produced to indicate that the value doesn't match one of the enumerated values. + The actual value MUST match one of the enumerated values declared on any of the `` constraints in the *targeting set*. An error MUST be produced to indicate that the value doesn't match one of the enumerated values. -2. All `` constraints in the *target set* MUST have the `@allow-other` attribute value `yes`. The *expected value set* is *open*. +2. All `` constraints in the *targeting set* MUST have the `@allow-other` attribute value `yes`. The *expected value set* is *open*. Any type-appropriate actual value MUST be allowed. A warning MAY be produced to indicate that the value doesn't match one of the enumerated values.