Skip to content

Commit 2d684a4

Browse files
joshmoorerabernatnormanrz
authored
Apply suggestions from code review
Co-authored-by: Ryan Abernathey <[email protected]> Co-authored-by: Norman Rzepka <[email protected]>
1 parent 2861c84 commit 2d684a4

File tree

1 file changed

+6
-3
lines changed

1 file changed

+6
-3
lines changed

docs/v3/core/index.rst

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1581,7 +1581,8 @@ Registered names are unique and immutable.
15811581
Registered names MUST start with one lower case letter a-z and then be followed
15821582
by only lower case letters a-z, numerals 0-9, underscores, dots and dashes.
15831583

1584-
Registered names MUST be assigned within a central repository, `zarr-extensions`_
1584+
Prior to release in any implementation,
1585+
registered names MUST be assigned within a central repository, `zarr-extensions`_
15851586
a Github repository, where extensions and their specification are listed.
15861587
The Zarr Steering Council or by delegation a
15871588
maintainer team reserves the right to refuse name assignment at its own
@@ -1593,6 +1594,7 @@ discretion.
15931594
- ``numcodecs.adler32``
15941595
- **Invalid examples:**
15951596
- ``foo/bar``
1597+
- ``foo:bar``
15961598

15971599
.. _extension-naming-unregistered-names:
15981600

@@ -1603,14 +1605,15 @@ Unregistered names are intended for private extensions and for experimental and
16031605

16041606
Unregistered names are not centrally managed and MAY be used by any extension without coordination.
16051607

1606-
Unregistered names consist of URIs, which are prefixed with a scheme beginning
1608+
Unregistered names MUST be URIs, which are prefixed with a scheme beginning
16071609
with a letter and followed by any number of letters, numbers, plus symbols,
16081610
dashes or dots and then followed by a colon.
1611+
The use of URI names ensures that unregistered extensions will never conflict with or override registered extensions.
16091612

16101613
- **Identifying regex:** ``^([a-z][a-z0-9-_]+\.)+[a-z][a-z0-9-_]+:``
16111614

16121615
URIs (`Uniform Resource Identifiers <https://en.wikipedia.org/wiki/Uniform_Resource_Identifier>`_)
1613-
are a well-known mechanism to identify resources on the internet and extension authors are
1616+
are a well-known mechanism to identify abstract or phyiscal resources and extension authors are
16141617
encouraged to explore further documentation on which identifiers might best express their intent.
16151618

16161619
Aware that not all extension developers will want to immediately register a name,

0 commit comments

Comments
 (0)