Skip to content

Commit 454faaf

Browse files
committed
More crosslinks and identifier clarifications
1 parent c1accfe commit 454faaf

File tree

1 file changed

+10
-6
lines changed

1 file changed

+10
-6
lines changed

docs/v3/core/v3.0.rst

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -494,9 +494,10 @@ mandatory names:
494494
identifier provided as a string. For example, ``"float64"`` for
495495
little-endian 64-bit floating point number.
496496

497-
The ``data_type`` value is an extension point and may be defined by a data
497+
The ``data_type`` value is an :ref:`extension point<extensions_section>`
498+
and may be defined by a data
498499
type extension. If the data type is defined by an extension, then the value
499-
may be either a plain string or an object containing the members ``name``
500+
may be either a plain string (incl. URI) or an object containing the members ``name``
500501
and optionally ``configuration``. A plain string is equivalent to
501502
specifying an object with just a ``name`` member. The ``name`` is required
502503
and its value must refer to a v3 data type specification. ``configuration``
@@ -516,7 +517,8 @@ mandatory names:
516517
means a regular grid where the chunks have length 2 along the first
517518
dimension and length 5 along the second dimension.
518519

519-
The ``chunk_grid`` value is an extension point and may be defined by an
520+
The ``chunk_grid`` value is an :ref:`extension point<extensions_section>`
521+
and may be defined by an
520522
extension. If the chunk grid type is defined by an extension, then ``name``
521523
must be a string referring to a v3 chunk grid specification. The
522524
``configuration`` is optional and defined by the extension.
@@ -655,7 +657,7 @@ mandatory names:
655657
""""""""""
656658

657659
Specifies a list of codecs to be used for encoding and decoding chunks. The
658-
value MUST be an array of extension definitions as defined under TODO.
660+
value MUST be an array of :ref:`extension definitions<extensions_section>`.
659661
Because ``codecs`` MUST contain an ``array
660662
-> bytes`` codec, the list cannot be empty (See :ref:`codecs <codecs>`).
661663

@@ -929,7 +931,8 @@ should be interpreted.
929931

930932
This core specification defines a limited set of data types to
931933
represent boolean values, integers, and floating point
932-
numbers. Extensions may define additional data types. All of the data
934+
numbers. :ref:`Extensions<extensions_section>` may define additional
935+
data types. All of the data
933936
types defined here have a fixed size, in the sense that all values
934937
require the same number of bytes. However, extensions may define
935938
variable sized data types.
@@ -1020,7 +1023,8 @@ chunk, and there are no gaps or overlaps between chunks.
10201023

10211024
In general there are different possible types of grids. The core
10221025
specification defines the regular grid type, where all chunks are
1023-
hyperrectangles of the same shape. Extensions may define other grid
1026+
hyperrectangles of the same shape.
1027+
:ref:`Extensions<extensions_section>` may define other grid
10241028
types, such as rectilinear grids where chunks are still
10251029
hyperrectangles but do not all share the same shape.
10261030

0 commit comments

Comments
 (0)