diff --git a/policyAndProcedures/OGCBuildingBlocksRegistration/document.html b/policyAndProcedures/OGCBuildingBlocksRegistration/document.html index afbe9803..a00cdb33 100644 --- a/policyAndProcedures/OGCBuildingBlocksRegistration/document.html +++ b/policyAndProcedures/OGCBuildingBlocksRegistration/document.html @@ -1410,23 +1410,25 @@ @@ -1441,7 +1443,7 @@
-

I.  Abstract

The mission of the OGC Naming Authority (OGC-NA) is to provide the means through which OGC resources such as OGC documents, namespaces and ontologies can be controlled and managed such that they can provide clear and well-defined names and definitions. In the terminology defined in ISO 19135, OGC-NA is the Control Body for the register of OGC Names. This document describes the framework of documents, registers and other resources required for OGC-NA to execute that role.

II.  Keywords

The following are keywords to be used by search engines and document catalogues.

keyword_1, keyword_2, keyword_3, etc.


III.  Preface

This document describes the procedures used by the OGC Naming Authority for the registration of OGC Standards Building Blocks.

IV.  Security Considerations

No security considerations have been made for this Standard.

V.  Submitters

All questions regarding this submission should be directed to the editor or the submitters:

NameAffiliation
Gobe HobonaOGC
TBATBA
TBATBA
TBATBA
TBATBA

1.  Scope

This OGC Policy specifies the governance rules and procedures for the registration of OGC Standards Building Blocks. The policy can be considered a profile of OGC 09-046r6, OGC Naming Authority — Procedures policy.

Clause 7.2.1 of the OGC Technical Committee’s Policies and Procedures (OGC 05-020r29) defines a Standard Building Block as follows:

__”Many OGC Standards are structured with modular sets of requirements (or requirement classes) that collectively function as a reusable building block. There is no firm definition for the content or scope of a building block, but the building block must fulfill a function that can operate in the larger context of an implementation, including combination with other OGC building blocks to create novel implementations.

Building blocks developed for one Standard can be reused in another Standard. To facilitate such reuse, a Standard constructed of building blocks shall identify each building block and publish a definition of the building block to OGC’s Registries and web resources. The definition will be in the form most suitable for the type of building block (e.g., Open API for a Standardized API), reference the owning Standard, and be adequately documented to be used in reference.

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.”__

NOTE:    The planned revision of “The Specification Model — A Standard for Modular specifications” (OGC 08-131r3), also known as the ModSpec, is expected to include a more precise definition of a Standards Building Block.

2.  Normative references

+


I.  Abstract

The mission of the OGC Naming Authority (OGC-NA) is to provide the means through which OGC resources such as OGC documents, namespaces and ontologies can be controlled and managed such that they can provide clear and well-defined names and definitions. In the terminology defined in ISO 19135, OGC-NA is the Control Body for the register of OGC Names. This document describes the framework of documents, registers and other resources required for OGC-NA to execute that role.

II.  Keywords

The following are keywords to be used by search engines and document catalogues.

keyword_1, keyword_2, keyword_3, etc.


III.  Preface

This document describes the procedures used by the OGC Naming Authority for the registration of OGC Standards Building Blocks.

IV.  Security Considerations

No security considerations have been made for this Standard.

V.  Submitters

All questions regarding this submission should be directed to the editor or the submitters:

NameAffiliation
Gobe HobonaOGC
TBATBA
TBATBA
TBATBA
TBATBA

1.  Scope

This OGC Policy specifies the governance rules and procedures for the registration of OGC Standards Building Blocks. The policy can be considered a profile of OGC 09-046r6, OGC Naming Authority — Procedures policy.

Clause 7.2.1 of the OGC Technical Committee’s Policies and Procedures (OGC 05-020r29) defines a Standard Building Block as follows:

__”Many OGC Standards are structured with modular sets of requirements (or requirement classes) that collectively function as a reusable building block. There is no firm definition for the content or scope of a building block, but the building block must fulfill a function that can operate in the larger context of an implementation, including combination with other OGC building blocks to create novel implementations.

Building blocks developed for one Standard can be reused in another Standard. To facilitate such reuse, a Standard constructed of building blocks shall identify each building block and publish a definition of the building block to OGC’s Registries and web resources. The definition will be in the form most suitable for the type of building block (e.g., Open API for a Standardized API), reference the owning Standard, and be adequately documented to be used in reference.

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.”__

NOTE:    The planned revision of “The Specification Model — A Standard for Modular specifications” (OGC 08-131r3), also known as the ModSpec, is expected to include a more precise definition of a Standards Building Block.

2.  Normative references

The following documents are referred to in the text in such a way that some or all of their content constitutes requirements of this document. For dated references, only the edition cited applies. For undated references, the latest edition of the referenced document (including any amendments) applies.

@@ -1449,7 +1451,7 @@

George Percivall: OGC 06-030r12, OGC Architecture Board (OAB) Policies and Procedures. Open Geospatial Consortium (2018), https://portal.ogc.org/files/?artifact_id=90860

Gobe Hobona, Simon Cox: OGC 09-046r6, OGC Naming Authority — Procedures. Open Geospatial Consortium (2021). http://www.opengis.net/doc/POL/OGC-NA/1.3.

Policy SWG: OGC 08-131r3, The Specification Model — Standard for Modular specifications. Open Geospatial Consortium (2009).

-

3.  Terms definitions and abbreviated terms

3.1.  Terms and definitions

+

3.  Terms definitions and abbreviated terms

3.1.  Terms and definitions

3.1.1.  conformance test

@@ -1474,30 +1476,46 @@
-

4.  Considerations for Registration

4.1.  Granularity

+

4.  Considerations for Registration

4.1.  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.

+

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.

4.1.1.  Level 1: Conformance Classes and Requirements Classes

-

TBA

+

TBA

4.1.2.  Level 2: Requirements and Abstract Tests

-

TBA

+

TBA

4.1.3.  Level 3: Schema documents and API definition documents

-

TBA

+

TBA

4.1.4.  Level 4: Schema fragments and Parameters

-

TBA

+

TBA

-

5.  Roles

The following table identifies the roles involved in the registration and maintenance of the OGC Standards Building Blocks register and the registry that hosts the register.

Table 1

RoleAssignee
Control BodyOGC Naming Authority
Register OwnerOGC Architecture Board
Submitting OrganizationStandards Working Group
Register ManagerOGC-NA Chair
Registry ManagerOGC Staff
Appeals LeadTC Chair
Register UserGeneral Public

6.  Processes

6.1.  Review by the OGC Architecture Board

+

4.2.  Reusability

+ +

TBA

+ +

4.2.1.  TBA

+ +

TBA

+
+

4.3.  Interfacing between Standards Building Blocks

+ +

TBA

+ +

4.3.1.  TBA

+ +

TBA

+
+

5.  Roles

The following table identifies the roles involved in the registration and maintenance of the OGC Standards Building Blocks register and the registry that hosts the register.

Table 1

RoleAssignee
Control BodyOGC Naming Authority
Register OwnerOGC Architecture Board
Submitting OrganizationStandards Working Group
Register ManagerOGC-NA Chair
Registry ManagerOGC Staff
Appeals LeadTC Chair
Register UserGeneral Public

6.  Processes

6.1.  Review by the OGC Architecture Board

Each OGC candidate Standard goes through a series of stages on the way to approval by the TC. One of those stages is the review by the OGC Architecture Board (OAB).

@@ -1531,13 +1549,13 @@

Process:

-
  1. OAB Chair begins a period of review by the OAB

    +
    1. OAB Chair begins a period of review by the OAB

    2. -
    3. OAB evaludates the structure of the proposed building block(s)

      +
    4. OAB evaludates the structure of the proposed building block(s)

    5. -
    6. OAB Chair conducts a vote on the approval of the proposed level of granularity, reusability, and interfacing of the building block(s)

      +
    7. OAB Chair conducts a vote on the approval of the proposed level of granularity, reusability, and interfacing of the building block(s)

    8. -
    9. OAB Chair creates a ticket, on the OGC-NA Git repository, with the result of the OAB vote

      +
    10. OAB Chair creates a ticket, on the OGC-NA Git repository, with the result of the OAB vote

    @@ -1550,7 +1568,7 @@ -

6.2.  Review by the OGC Naming Authority SubCommittee

+

6.2.  Review by the OGC Naming Authority SubCommittee

The mission of the OGC Naming Authority (OGC-NA) is to provide the means through which OGC resources such as OGC documents, namespaces and ontologies can be controlled and managed such that they can provide clear and well-defined names and definitions (OGC 09-046r6).

@@ -1576,13 +1594,13 @@

Process:

-
  1. OGC-NA Chair begins a period of review by the OGC-NA

    +
    1. OGC-NA Chair begins a period of review by the OGC-NA

    2. -
    3. OGC-NA Chair conducts a vote on registration of the building block or as a group of building blocks

      +
    4. OGC-NA Chair conducts a vote on registration of the building block or as a group of building blocks

    5. -
    6. If the vote passes, OGC Staff register the building block or group of building blocks in the register.

      +
    7. If the vote passes, OGC Staff register the building block or group of building blocks in the register.

    8. -
    9. If the vote fails to pass, then OGC-NA Chair asks the SWG to revise the proposal before resubmission.

      +
    10. If the vote fails to pass, then OGC-NA Chair asks the SWG to revise the proposal before resubmission.

    @@ -1591,7 +1609,7 @@
    • Registered Building Block displayed on the registry

    -

6.3.  Appeals

+

6.3.  Appeals

A SWG may appeal to the TC Chair if it disagrees with the decisions of the OAB or OGC-NA regarding building block registration.

@@ -1609,11 +1627,11 @@

Process:

-
  1. SWG submits appeal form to the TC Chair

    +
    1. SWG submits appeal form to the TC Chair

    2. -
    3. TC Chair convenes an Appeals Panel consisting of OAB and OGC-NA members, and invites the SWG

      +
    4. TC Chair convenes an Appeals Panel consisting of OAB and OGC-NA members, and invites the SWG

    5. -
    6. The Appeals Panel votes on whether to uphold the OAB/OGC-NA decision

      +
    7. The Appeals Panel votes on whether to uphold the OAB/OGC-NA decision

    @@ -1634,7 +1652,7 @@
  2. a statement of the impact if the appeal is not successful

  3. -

Annex A
(informative)
Revision History

Table A.1 — Revision History

DateReleaseEditorPrimary clauses modifiedDescription
2024-02-040.0.1G. HobonaallInitial draft