From 3dd4beaade4a0528bd17917a07511dffe8394314 Mon Sep 17 00:00:00 2001 From: Gobe Hobona Date: Fri, 9 Feb 2024 15:37:02 +0000 Subject: [PATCH] 24-005 --- .../document.adoc | 8 +++++-- .../sections/01-scope.adoc | 1 + .../sections/03-references.adoc | 2 ++ .../sections/04-considerations.adoc | 22 +++++++++++++++++++ .../sections/{04-roles.adoc => 05-roles.adoc} | 0 .../{05-processes.adoc => 06-processes.adoc} | 0 .../sections/annex-history.adoc | 11 ++++++++++ 7 files changed, 42 insertions(+), 2 deletions(-) create mode 100644 policyAndProcedures/OGCBuildingBlocksRegistration/sections/04-considerations.adoc rename policyAndProcedures/OGCBuildingBlocksRegistration/sections/{04-roles.adoc => 05-roles.adoc} (100%) rename policyAndProcedures/OGCBuildingBlocksRegistration/sections/{05-processes.adoc => 06-processes.adoc} (100%) create mode 100644 policyAndProcedures/OGCBuildingBlocksRegistration/sections/annex-history.adoc diff --git a/policyAndProcedures/OGCBuildingBlocksRegistration/document.adoc b/policyAndProcedures/OGCBuildingBlocksRegistration/document.adoc index c68ebbe0..3fdb533d 100644 --- a/policyAndProcedures/OGCBuildingBlocksRegistration/document.adoc +++ b/policyAndProcedures/OGCBuildingBlocksRegistration/document.adoc @@ -46,12 +46,16 @@ include::sections/02-terms-and-definitions.adoc[] include::sections/03-references.adoc[] // Add clause files as needed -include::sections/04-roles.adoc[] +include::sections/04-considerations.adoc[] -include::sections/05-processes.adoc[] +include::sections/05-roles.adoc[] + +include::sections/06-processes.adoc[] //// Annexes Add annex files as needed //// + +include::sections/annex-history.adoc[] \ No newline at end of file diff --git a/policyAndProcedures/OGCBuildingBlocksRegistration/sections/01-scope.adoc b/policyAndProcedures/OGCBuildingBlocksRegistration/sections/01-scope.adoc index 7940339a..e29da0ab 100644 --- a/policyAndProcedures/OGCBuildingBlocksRegistration/sections/01-scope.adoc +++ b/policyAndProcedures/OGCBuildingBlocksRegistration/sections/01-scope.adoc @@ -12,3 +12,4 @@ Building blocks developed for one Standard can be reused in another Standard. To OGC Standards that reuse building blocks from other Standards must include in the Normative References a reference to the owning Standard of the building block(s) and a direct reference to the registered building block(s) content. In this fashion, implementers of the Standard reusing these building blocks need to only access specific parts (the building blocks) of the referenced Standard, not the entire document."__ + diff --git a/policyAndProcedures/OGCBuildingBlocksRegistration/sections/03-references.adoc b/policyAndProcedures/OGCBuildingBlocksRegistration/sections/03-references.adoc index 5a1f9575..75104f69 100644 --- a/policyAndProcedures/OGCBuildingBlocksRegistration/sections/03-references.adoc +++ b/policyAndProcedures/OGCBuildingBlocksRegistration/sections/03-references.adoc @@ -5,3 +5,5 @@ The following normative documents contain provisions that, through reference in * [[[ogc06-030r12,OGC 06-030r12]]], George Percivall: OGC 06-030r12, OGC Architecture Board (OAB) Policies and Procedures (2018), https://portal.ogc.org/files/?artifact_id=90860 * [[[ogc09-046r6,OGC 09-046r6]]], Gobe Hobona, Simon Cox: OGC 09-046r6, OGC Naming Authority - Procedures (2021), https://docs.ogc.org/pol/09-046r6.html +* [[[ogc08-131r3,OGC08-131r3]]], Policy SWG: OGC 08-131r3, The Specification Model — A Standard for Modular specifications (2009), https://portal.opengeospatial.org/files/?artifact_id=34762 + diff --git a/policyAndProcedures/OGCBuildingBlocksRegistration/sections/04-considerations.adoc b/policyAndProcedures/OGCBuildingBlocksRegistration/sections/04-considerations.adoc new file mode 100644 index 00000000..9b178cd9 --- /dev/null +++ b/policyAndProcedures/OGCBuildingBlocksRegistration/sections/04-considerations.adoc @@ -0,0 +1,22 @@ +[[considerations]] +== Considerations for Registration + +=== Granularity + +OGC Standards are composed of specification elements as defined in the OGC Standard for Modular specifications (OGC 08-131r3), also known as the ModSpec. These specification elements include requirements classes, requirements, conformance classes, and abstract tests. Each one of these specification elements may reference other constructs or artifacts such as schema documents, schema fragments, parameters, API definition documents, or others. Those constructs or artifacts may themselves reference others. Therefore, a key consideration for the registration of Standards Building Blocks is at what level of granularity a building block should be registered. The following are the levels of granularity that may be considered for registration. + +==== Level 1: Conformance Classes and Requirements Classes + +TBA + +==== Level 2: Requirements and Abstract Tests + +TBA + +==== Level 3: Schema documents and API definition documents + +TBA + +==== Level 4: Schema fragments and Parameters + +TBA \ No newline at end of file diff --git a/policyAndProcedures/OGCBuildingBlocksRegistration/sections/04-roles.adoc b/policyAndProcedures/OGCBuildingBlocksRegistration/sections/05-roles.adoc similarity index 100% rename from policyAndProcedures/OGCBuildingBlocksRegistration/sections/04-roles.adoc rename to policyAndProcedures/OGCBuildingBlocksRegistration/sections/05-roles.adoc diff --git a/policyAndProcedures/OGCBuildingBlocksRegistration/sections/05-processes.adoc b/policyAndProcedures/OGCBuildingBlocksRegistration/sections/06-processes.adoc similarity index 100% rename from policyAndProcedures/OGCBuildingBlocksRegistration/sections/05-processes.adoc rename to policyAndProcedures/OGCBuildingBlocksRegistration/sections/06-processes.adoc diff --git a/policyAndProcedures/OGCBuildingBlocksRegistration/sections/annex-history.adoc b/policyAndProcedures/OGCBuildingBlocksRegistration/sections/annex-history.adoc new file mode 100644 index 00000000..43a2bb33 --- /dev/null +++ b/policyAndProcedures/OGCBuildingBlocksRegistration/sections/annex-history.adoc @@ -0,0 +1,11 @@ +[appendix] +:appendix-caption: Annex +== Revision History + +[#revision-history,reftext='{table-caption} {counter:table-num}'] +.Revision History +[cols="12,18,12,12,46",options="header"] +|=== +|Date |Release |Editor | Primary clauses modified |Description +|2024-02-04 |0.0.1 |G. Hobona |all |Initial draft +|=== \ No newline at end of file