search

opengeospatial / cdb-volume-5

Repository for OGC CDB Volume 5
http://www.github.com/opengeospatial/cdb-volume-5
0 stars 0 forks source link

URI namespace of specification elements breaks OGC-NA policy #1

Open ghobona opened 4 years ago

ghobona commented 4 years ago

URI namespace of specification elements breaks OGC-NA policy

CDB 1.1 Volume 5 states that:

The normative provisions in this Best Practice are denoted by the URI

http://www.opengis.net/spec/1.1/cdb-radar

All requirements and conformance tests that appear in this document are denoted by partial URIs which are relative to this base.

For the sake of brevity, the use of “req” in a requirement URI denotes:

http://www.opengis.net/spec/core/1.1/cdb-radar

An example might be:

req/cdb-radar/storage

The text above does not comply with OGC-NA policy. Please see Sections 5.3 and 5.4 of OGC-NA Name type specification - specification elements (10-103) http://portal.opengeospatial.org/files/?artifact_id=39194

The text implies that ‘req’ replaces 'http://www.opengis.net/spec/cdb/1.1/cdb-radar’.

To fix this, I recommend that the text be changed to say.

The normative provisions in this standard are denoted by the URI namespace

    http://www.opengis.net/spec/cdb/1.1/cdb-radar

All requirements that appear in this document are denoted by partial URIs which are relative to the namespace shown above.

For the sake of brevity, the use of “req” in a requirement URI denotes:
      http://www.opengis.net/spec/cdb/1.1/cdb-radar/req

All conformance tests that appear in this document are denoted by partial URIs which are relative to the namespace shown above.

For the sake of brevity, the use of “conf” in a requirement URI denotes:
        http://www.opengis.net/spec/cdb/1.1/cdb-radar/conf

This issue may affect CDB 1.2 as well. So that document needs to be checked too.

cnreediii commented 4 years ago

Corrected as recommended.