20241210 separate into parts

sources/part1/00-preface.adoc

@@ -0,0 +1,82 @@
+[.preface]
+== Preface
+
+This OGC member developed and approved document defines a model and related requirements and recommendations for writing and structuring modular standards documents. Further, this model is designed to enable the consistent and verifiable testing of implementations of a standard that claim conformance.
+
+The goal is to ensure that a standard specifies requirements in a common and consistent manner and that these requirements are testable.
+
+NOTE: For OGC only: Any new OGC Standard, abstract specification that contains requirements, or major revision of an existing OGC Standard shall comply with the requirements stated in this document.
+
+NOTE: Historically, this document has been known and abbreviated as the "ModSpec". For continuity and ease of understanding this document may also be refered to as the "OGC ModSpec".
+
+Suggested additions, changes, and comments on this this document are welcome and
+encouraged. Such suggestions may be submitted through the OGC Change Request System
+(http://www.opengeospatial.org/standards/cr) or by creating an issue in the GitHub repository for this document (https://github.com/opengeospatial/ogc-modspec).
+
+[.preface]
+== Document terms and definitions
+
+This document uses the standard terms defined in Subclause 5.3 of [OGC 05-008], which
+is based on the ISO/IEC Directives, Part 2. Rules for the structure and drafting of
+International Standards. In particular, the word "shall" (not "must") is the
+imperative verb form used to indicate a requirement to be strictly followed to
+conform to this standard.
+
+[.preface]
+== Document editors
+
+The following OGC Members participated in editing this document:
+
+[%unnumbered]
+|===
+^h| Person ^h| Organization Represented
+| Carl Reed | Carl Reed & Associates
+| Chuck Heazel | Heazeltech
+|===
+
+[.preface]
+== Document Contributors
+
+The following OGC Members contributed and particpated in developing Version 2 of the ModSpec.
+
+[%unnumbered]
+|===
+^h| Person ^h| Organization Represented
+| Simon Cox | CSIRO and OGC Fellow
+| Chuck Heazel | Heazeltech
+| Clemens Portele | interactive instruments GmbH
+| Jeff Yutzler | ImageMatters
+|===
+
+[.preface]
+== Acknowledgements
+
+The following OGC Members were key contributors to Version 1 of the ModSpec
+
+[%unnumbered]
+|===
+^h| Person ^h| Organization Represented
+| Simon Cox | CSIRO
+| David Danko | ESRI
+| James Greenwood | SeiCorp, Inc.
+| John R. Herring | Oracle USA
+| Andreas Matheus | University of the Bundeswehr -- ITS
+| Richard Pearsall | US National Geospatial-Intelligence Agency (NGA)
+| Clemens Portele | interactive instruments GmbH
+| Barry Reff | US Department of Homeland Security (DHS)
+| Paul Scarponcini | Bentley Systems, Inc.
+| Arliss Whiteside | BAE Systems - C3I Systems
+|===
+
+[.preface]
+== Revision history
+
+This is the second normative version of this document.
+
+[.preface]
+== Future work
+
+Improvements to this document will be made based on implementation and changing technical requirements. Planned extensions include:
+
+- ModSpec Part providing requirements and recommendations for specifying requirements and conformance tests using RDFS, SHACL, and OWL.
+- ModSpec Part providing requirements and recommendations for specifying requirements and conformance tests using JSON.

sources/part1/document.adoc

@@ -21,7 +21,7 @@
 :local-cache-only:
 :data-uri-image:
 
-include::../sections/00-preface.adoc[]
+include::00-preface.adoc[]
 
 include::00-foreword.adoc[]
 

sources/part2/00-preface.adoc

@@ -0,0 +1,82 @@
+[.preface]
+== Preface
+
+This OGC member developed and approved document defines a model and related requirements and recommendations for writing and structuring modular standards documents. Further, this model is designed to enable the consistent and verifiable testing of implementations of a standard that claim conformance.
+
+The goal is to ensure that a standard specifies requirements in a common and consistent manner and that these requirements are testable.
+
+NOTE: For OGC only: Any new OGC Standard, abstract specification that contains requirements, or major revision of an existing OGC Standard shall comply with the requirements stated in this document.
+
+NOTE: Historically, this document has been known and abbreviated as the "ModSpec". For continuity and ease of understanding this document may also be refered to as the "OGC ModSpec".
+
+Suggested additions, changes, and comments on this this document are welcome and
+encouraged. Such suggestions may be submitted through the OGC Change Request System
+(http://www.opengeospatial.org/standards/cr) or by creating an issue in the GitHub repository for this document (https://github.com/opengeospatial/ogc-modspec).
+
+[.preface]
+== Document terms and definitions
+
+This document uses the standard terms defined in Subclause 5.3 of [OGC 05-008], which
+is based on the ISO/IEC Directives, Part 2. Rules for the structure and drafting of
+International Standards. In particular, the word "shall" (not "must") is the
+imperative verb form used to indicate a requirement to be strictly followed to
+conform to this standard.
+
+[.preface]
+== Document editors
+
+The following OGC Members participated in editing this document:
+
+[%unnumbered]
+|===
+^h| Person ^h| Organization Represented
+| Carl Reed | Carl Reed & Associates
+| Chuck Heazel | Heazeltech
+|===
+
+[.preface]
+== Document Contributors
+
+The following OGC Members contributed and particpated in developing Version 2 of the ModSpec.
+
+[%unnumbered]
+|===
+^h| Person ^h| Organization Represented
+| Simon Cox | CSIRO and OGC Fellow
+| Chuck Heazel | Heazeltech
+| Clemens Portele | interactive instruments GmbH
+| Jeff Yutzler | ImageMatters
+|===
+
+[.preface]
+== Acknowledgements
+
+The following OGC Members were key contributors to Version 1 of the ModSpec
+
+[%unnumbered]
+|===
+^h| Person ^h| Organization Represented
+| Simon Cox | CSIRO
+| David Danko | ESRI
+| James Greenwood | SeiCorp, Inc.
+| John R. Herring | Oracle USA
+| Andreas Matheus | University of the Bundeswehr -- ITS
+| Richard Pearsall | US National Geospatial-Intelligence Agency (NGA)
+| Clemens Portele | interactive instruments GmbH
+| Barry Reff | US Department of Homeland Security (DHS)
+| Paul Scarponcini | Bentley Systems, Inc.
+| Arliss Whiteside | BAE Systems - C3I Systems
+|===
+
+[.preface]
+== Revision history
+
+This is the second normative version of this document.
+
+[.preface]
+== Future work
+
+Improvements to this document will be made based on implementation and changing technical requirements. Planned extensions include:
+
+- ModSpec Part providing requirements and recommendations for specifying requirements and conformance tests using RDFS, SHACL, and OWL.
+- ModSpec Part providing requirements and recommendations for specifying requirements and conformance tests using JSON.

sources/part2/document.adoc

@@ -1,4 +1,4 @@
-= The ModSpec Model - Part 1: UML
+= The ModSpec Model - Part 2: XML
 :doctype: draft standard
 :docsubtype: logical-model
 :status: Draft
@@ -21,7 +21,7 @@
 :local-cache-only:
 :data-uri-image:
 
-include::../sections/00-preface.adoc[]
+include::00-preface.adoc[]
 
 include::00-foreword.adoc[]
 
@@ -37,4 +37,4 @@ include::05-conventions.adoc[]
 
 include::06-req-class.adoc[]
 
-include::aa-abstract-class.adoc[]
+include::aa-abstract-conformance.adoc[]