Skip to content

Commit

Permalink
Add content from earlier section and condense.
Browse files Browse the repository at this point in the history
  • Loading branch information
cnreediii authored Dec 9, 2024
1 parent 7f30599 commit 99f386e
Showing 1 changed file with 7 additions and 2 deletions.
9 changes: 7 additions & 2 deletions sources/sections/01-scope.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -4,20 +4,25 @@ The OGC Standard for Designing and Writing Modular Standards, also known as the

- Specifies rules for the internal structure and organization of a standard.
- Defines requirements for specifying the structure of a standards document as organized sets of criteria, those that are to be tested ("requirements") and those that are not tested ("recommendations" and "permissions").
- Designed to enable the clear and concise specification of requirements (the _shalls_ or _musts_ in a standard) that fully supports the ability to define implementable conformance tests.
- Is designed to enable the clear and concise specification of requirements (the _shalls_ or _musts_ in a standard) that fully supports the ability to define implementable conformance tests.
- By formally implementing the requirements specified in the ModSpec, reusable, modular standards can be developed.

The standardization goal of the ModSpec is to define characteristics and a structure for the specification of Standards
that will encourage implementation by minimizing difficulty determining
requirements, mimicking implementation structure, and maximizing usability and
interoperability.
interoperability.The goal of this approach is to enable implementations of a standard to be tested and deemed _conformant_ or not.

NOTE: For OGC Standards work, the word “standard” in the ModSpec applies to all OGC draft standards, approved standards, draft Abstract Specifications, and approved Abstract Specifications. The exceptions are OGC Abstract Specifications that originate in ISO or Community Standards that are developed external to the OGC and then submitted to the OGC.

Therefore, a standard that follows the rules specified in the ModSpec presents requirements organized in requirements classes which must be satisfied by passing the tests defined in a conformance suite (also known as the Abstract Test Suite in an OGC Standard). These tests are organized into conformance classes, each of which represents a mechanism for partial satisfaction of the standard. This results in a standard having a modular structure, where each requirements class has a corresponding conformance (test) class. In a well written standard, the normative clauses and any model or schema are organized in a manner that parallels the requirements and conformance clauses. A goal of the design pattern is the ability to define requirements classes and associated conformance classes that can be used across multiple standards.

<<Annex-B>> defines the UML model upon which the ModSpec is
based. Annex B also contains informal and non-normative definitions ordered for ease
of understanding. These two sections can be read first to aid in the understanding of
the rest of the document.

NOTE: Please note that the ModSpec has been approved by the OGC Membership as a policy directive for the development and revision of any OGC Standard or Abstract Specification that has requirements. However, the ModSpec is written to be non-OGC specific and can be used by any Standards Development Organization (SDO) as a formal guide for structuring a standards document.

[[things-to-know]]
=== Things to know

Expand Down

0 comments on commit 99f386e

Please sign in to comment.