search

NIEM / NIEM-NDR

The NIEM Naming and Design Rules
https://niem.github.io/NIEM-NDR/
6 stars 6 forks source link

Information about permitted external attribute uses in Section 10.2.3 is a little confusing #24

Closed cdmgtri closed 4 years ago

cdmgtri commented 7 years ago

Section 10.2.3. External adapter types and external components

Text says non-adapter types can use external attributes:

  1. A type that is not an external adapter type may incorporate externally-defined attributes.

Rule title says only adapter types can use external attributes:

Rule 10-13. External attribute use only in external adapter type

These two statements sound like they contradict each other until you read the text following the title of Rule 10-13, which explains that the rule applies to reference schemas and not extension schemas.

Would be clearer to qualify this at the start. Something like:

  1. A type that is not an external adapter type and that is defined by an extension schema document may incorporate externally-defined attributes.