Skip to content

Commit c7f3668

Browse files
committed
update
1 parent ff7c400 commit c7f3668

File tree

2 files changed

+4
-4
lines changed

2 files changed

+4
-4
lines changed

prefixes.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ <h2>Prefix Registry</h2>
1313
In order to avoid name clashes (both with other extensions and future versions of the format)
1414
it is recommended to use names of the form <code>"prefix:suffix"</code>.
1515
If CoverageJSON documents using that prefix shall be published more widely,
16-
then it should be registered together with the corresponding namespace URI.
16+
then the prefix should be registered together with the corresponding namespace URI.
1717
A registration avoids name clashes and eases common understanding of extensions without establishing the full
1818
machinery of JSON-LD for example.
1919
More details can be found in the <a href="http://covjson.org/spec/#extensions">"Extensions" section</a>

spec.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -846,7 +846,7 @@ Custom types MAY be used with the following members:
846846
- `"type"` in unit symbol objects
847847
- `"type"` within custom members that have an object as value
848848

849-
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 http://covjson.org/prefixes/.
849+
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 <http://covjson.org/prefixes/>.
850850

851851
Example of a custom unit symbol type using an absolute URI:
852852

@@ -881,13 +881,13 @@ Example of a custom reference system type using a compact URI:
881881

882882
## 8. JSON-LD
883883

884-
If no JSON-LD context is given, then the default context `http://covjson.org/context.jsonld` SHALL be assumed. Note that this context includes registered namespace prefixes and MAY be updated in a backwards-compatible way as the format evolves.
884+
If no JSON-LD context is given, then the default context `http://covjson.org/context.jsonld` SHALL be assumed. Note that this context includes [registered namespace prefixes](http://covjson.org/prefixes/) and MAY be updated in a backwards-compatible way as the format evolves.
885885

886886
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.
887887

888888
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.
889889

890-
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 registered prefixes of compact URIs. On the other side, it would make documents less forward-compatible 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.
890+
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 [registered prefixes](http://covjson.org/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.
891891

892892
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.
893893

0 commit comments

Comments
 (0)