Skip to content

Commit bf12d64

Browse files
joshmoorerabernat
andauthored
Introduction of tag:
Co-authored-by: Ryan Abernathey <[email protected]>
1 parent 2d684a4 commit bf12d64

File tree

1 file changed

+10
-3
lines changed

1 file changed

+10
-3
lines changed

docs/v3/core/index.rst

Lines changed: 10 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1628,9 +1628,16 @@ be a URI that dereferences to a human-readable codec specification, i.e. a URL.
16281628
That is now discouraged for new extensions, though, for backwards compatibility
16291629
with existing extensions, URLs names are still permitted.
16301630

1631-
Instead, extension names SHOULD either be registered names as specified above or URNs.
1632-
URNs (`Uniform Resource Names <https://en.wikipedia.org/wiki/Uniform_Resource_Name>`_)
1633-
are simpler persistent identifiers assigned within defined namespaces.
1631+
Instead, new unregistered extension names SHOULD use the [Tag URI scheme](https://datatracker.ietf.org/doc/html/rfc4151).
1632+
The Tag URI scheme has four principal requirements:
1633+
> - Identifiers are likely to be unique across space and time, and come from a practically inexhaustible supply.
1634+
> - Identifiers are relatively convenient for humans to mint (create), read, type, remember etc.
1635+
> - No central registration is necessary, at least for holders of domain names or email addresses; and there is negligible cost to mint each new identifier.
1636+
> - The identifiers are independent of any particular resolution scheme.
1637+
1638+
These requirements are aligned well with the needs of Zarr extension developers.
1639+
1640+
An example of a Tag URI for a Zarr extension is `tag:[email protected],2025-03:experimental-new-dtype`.
16341641

16351642
.. _extension-guidance:
16361643

0 commit comments

Comments
 (0)