NIEM / NIEM-NDR

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

Repetition in Section 10.2.3. External adapter types and external components #22

Closed cdmgtri closed 4 years ago

cdmgtri commented 7 years ago

Section 10.2.3. External adapter types and external components

Repeats phrases "documentation...is undefined and variable" and "documentation...is required at their point of use" in a fairly short span.

Last two sentences before Section 12.2.3.1:

However, when an external schema document is imported, appropriate documentation must be provided at the point of import because documentation associated with external schema documents is undefined and variable. In this particular case, documentation of external schema documents is required at their point of use in NIEM.

Lase sentence before Rule 10-9 in Section 10.2.3.2. External adapter types

Since documentation made available by nonconformant schemas is undefined and variable, documentation of these components is required at their point of use, within the conformant schema.

Suggest leaving the second one as is and replacing the first with:

However, when an external schema document is imported, appropriate documentation must be provided at the point of import. This ensures that documentation for all external schema documents will be both available and accessible in a consistent manner.