Skip to content

Commit d93dff6

Browse files
authored
Update clause_specification_text.adoc
1 parent 84be157 commit d93dff6

1 file changed

Lines changed: 5 additions & 5 deletions

File tree

standard/clause_specification_text.adoc

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -114,7 +114,7 @@ ParameterGroup "0..1" *-- "1..*" Parameter
114114
//## 2. Version
115115
=== Version
116116

117-
The ``version`` property to identifies the version of the CoverageJSON standard that the metadata record conforms to, which is valuable for version-specific detection handling of content.
117+
The `version` property to identifies the version of the CoverageJSON standard that the content conforms to, which is valuable for version-specific detection handling of content. If there is no `version` property, the version is assumed to be V1.0.0.
118118

119119
Example:
120120

@@ -875,7 +875,7 @@ Example:
875875
}
876876
```
877877

878-
The prefix SHOULD be registered at <https://covjson.org/prefixes/> which in the example above would be `dct = http://purl.org/dc/terms/`.
878+
The prefix SHOULD be registered at <https://www.opengis.net/def/namespaces> which in the example above would be `dct = http://purl.org/dc/terms/`. In CoverageJSON V1.0.0 and earlier, prefixes were defined by the community register at <https://covjson.org/prefixes/>.
879879

880880
If the value of a custom member can have multiple structures, for example a string or an object, then a client should ignore the member if it does not understand the structure that is used.
881881

@@ -907,7 +907,7 @@ Custom types MAY be used with the following members:
907907
- `"type"` in unit symbol objects
908908
- `"type"` within custom members that have an object as value
909909

910-
The custom value of those members SHOULD be either an absolute URI or a compact URI. If a compact URI is used, then the prefix SHOULD be registered at <https://covjson.org/prefixes/>.
910+
The custom value of those members SHOULD be either an absolute URI or a compact URI. If a compact URI is used, then the prefix SHOULD be registered at <https://www.opengis.net/def/namespaces>.
911911

912912
Example of a custom unit symbol type using an absolute URI:
913913

@@ -945,13 +945,13 @@ Example of a custom reference system type using a compact URI:
945945
//## 9. JSON-LD
946946
=== JSON-LD
947947

948-
If no JSON-LD context is given, then the default context `https://covjson.org/context.jsonld` SHALL be assumed. Note that this context includes https://covjson.org/prefixes/[registered namespace prefixes] and MAY be updated in a backwards-compatible way as the format evolves.
948+
If no JSON-LD context is given, then the default context `https://covjson.org/context.jsonld` SHALL be assumed. Note that this context includes https://www.opengis.net/def/namespaces[registered namespace prefixes] and MAY be updated in a backwards-compatible way as the format evolves.
949949

950950
Additional semantics not provided by the default context MAY be provided by specifying an explicit `"@context"` member in the root of a CoverageJSON document. The value of that member MUST be an array where the first element is the default context URL. Any additional context definitions SHALL NOT override definitions of the default context, except when the definition is identical.
951951

952952
Providing an explicit context is especially useful for extensions. A recommended practice is to include any used namespace prefixes, even if registered, in the explicit context. This provides additional clarity and helps humans understand the document more quickly.
953953

954-
It is NOT RECOMMENDED to use the explicit JSON-LD context to map simple names, for example, `"license": "dct:license"`. On one side, this would hinder interoperability for generic non-JSON-LD clients, as they generally rely on absolute URIs or https://covjson.org/prefixes/[registered prefixes] of compact URIs. On the other side, it would make documents less future-proof as there may be name collisions with future versions of the format where semantics of that name may be defined differently. It is therefore RECOMMENDED to use compact or absolute URIs if an explicit JSON-LD context is included.
954+
It is NOT RECOMMENDED to use the explicit JSON-LD context to map simple names, for example, `"license": "dct:license"`. On one side, this would hinder interoperability for generic non-JSON-LD clients, as they generally rely on absolute URIs or https://www.opengis.net/def/namespaces[registered prefixes] of compact URIs. On the other side, it would make documents less future-proof as there may be name collisions with future versions of the format where semantics of that name may be defined differently. It is therefore RECOMMENDED to use compact or absolute URIs if an explicit JSON-LD context is included.
955955

956956
Note that domain axis values and range values SHOULD NOT be exposed as linked data via the JSON-LD context since they are not suitable for such representation.
957957

0 commit comments

Comments
 (0)