Skip to content

Commit

Permalink
Remove specs pages from docs
Browse files Browse the repository at this point in the history
  • Loading branch information
dstansby committed Dec 13, 2024
1 parent 01b73a7 commit 03dd2ef
Show file tree
Hide file tree
Showing 8 changed files with 20 additions and 44 deletions.
3 changes: 2 additions & 1 deletion docs/contributing.rst
Original file line number Diff line number Diff line change
Expand Up @@ -307,7 +307,8 @@ Data format compatibility
The data format used by Zarr is defined by a specification document, which should be
platform-independent and contain sufficient detail to construct an interoperable
software library to read and/or write Zarr data using any programming language. The
latest version of the specification document is available from the :ref:`spec` page.
latest version of the specification document is available on the
`Zarr specifications website<https://zarr-specs.readthedocs.io>`_.

Here, **data format compatibility** means that all software libraries that implement a
particular version of the Zarr storage specification are interoperable, in the sense
Expand Down
2 changes: 1 addition & 1 deletion docs/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,6 @@ Zarr-Python
tutorial
guide/index
api/index
spec
release
license
contributing
Expand All @@ -27,6 +26,7 @@ Zarr-Python
`Source Repository <https://github.com/zarr-developers/zarr-python>`_ |
`Issue Tracker <https://github.com/zarr-developers/zarr-python/issues>`_ |
`Zulip Chat <https://ossci.zulipchat.com/>`_
`Zarr specifications <https://zarr-specs.readthedocs.io>`_

Zarr is a file storage format for chunked, compressed, N-dimensional arrays based on an open-source specification.

Expand Down
20 changes: 10 additions & 10 deletions docs/release.rst
Original file line number Diff line number Diff line change
Expand Up @@ -216,17 +216,17 @@ Typing
Maintenance
~~~~~~~~~~~

* Remedy a situation where ``zarr-python`` was importing ``DummyStorageTransformer`` from the test suite.
* Remedy a situation where ``zarr-python`` was importing ``DummyStorageTransformer`` from the test suite.
The dependency relationship is now reversed: the test suite imports this class from ``zarr-python``.
By :user:`Davis Bennett <d-v-b>` :issue:`1601`.

* [V3] Update minimum supported Python and Numpy versions.
* [V3] Update minimum supported Python and Numpy versions.
By :user:`Joe Hamman <jhamman>` :issue:`1638`

* use src layout and use hatch for packaging.
By :user:`Davis Bennett <d-v-b>` :issue:`1592`.

* temporarily disable mypy in v3 directory.
* temporarily disable mypy in v3 directory.
By :user:`Joe Hamman <jhamman>` :issue:`1649`.

* create hatch test env.
Expand Down Expand Up @@ -313,10 +313,10 @@ Maintenance
Documentation
~~~~~~~~~~~~~

* Specify docs hatch env for v3 branch.
* Specify docs hatch env for v3 branch.
By :user:`Max Jones <maxrjones>` :issue:`1655`.

* Development installation/contributing docs updates.
* Development installation/contributing docs updates.
By :user:`Alden Keefe Sampson <aldenks>` :issue:`1643`.

* chore: update project settings per scientific python repo-review.
Expand All @@ -334,7 +334,7 @@ Enhancements
~~~~~~~~~~~~
* Added support for creating a copy of data when converting a `zarr.Array`
to a numpy array.
By :user:`David Stansby <dstansby>` (:issue:`2106`) and
By :user:`David Stansby <dstansby>` (:issue:`2106`) and
:user:`Joe Hamman <jhamman>` (:issue:`2123`).

Maintenance
Expand Down Expand Up @@ -2189,7 +2189,7 @@ Other changes
~~~~~~~~~~~~~

To accommodate support for hierarchies and filters, the Zarr metadata format
has been modified. See the :ref:`spec_v2` for more information. To migrate an
has been modified. See the ``spec_v2`` for more information. To migrate an
array stored using Zarr version 1.x, use the :func:`zarr.storage.migrate_1to2`
function.

Expand Down Expand Up @@ -2235,14 +2235,14 @@ abstraction layer between the core array logic and data storage (:issue:`21`).
In this release, any
object that implements the ``MutableMapping`` interface can be used as
an array store. See the tutorial sections on :ref:`tutorial_persist`
and :ref:`tutorial_storage`, the :ref:`spec_v1`, and the
and :ref:`tutorial_storage`, the ``spec_v1``, and the
:mod:`zarr.storage` module documentation for more information.

Please note also that the file organization and file name conventions
used when storing a Zarr array in a directory on the file system have
changed. Persistent Zarr arrays created using previous versions of the
software will not be compatible with this version. See the
:mod:`zarr.storage` API docs and the :ref:`spec_v1` for more
:mod:`zarr.storage` API docs and the ``spec_v1`` for more
information.

Compression
Expand All @@ -2255,7 +2255,7 @@ as the default compressor, however other compressors including zlib,
BZ2 and LZMA are also now supported via the Python standard
library. New compressors can also be dynamically registered for use
with Zarr. See the tutorial sections on :ref:`tutorial_compress` and
:ref:`tutorial_tips_blosc`, the :ref:`spec_v1`, and the
:ref:`tutorial_tips_blosc`, the ``spec_v1``, and the
:mod:`zarr.compressors` module documentation for more information.

Synchronization
Expand Down
11 changes: 0 additions & 11 deletions docs/spec.rst

This file was deleted.

7 changes: 0 additions & 7 deletions docs/spec/v1.rst

This file was deleted.

7 changes: 0 additions & 7 deletions docs/spec/v2.rst

This file was deleted.

7 changes: 0 additions & 7 deletions docs/spec/v3.rst

This file was deleted.

7 changes: 7 additions & 0 deletions test.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
import zarr

store = zarr.DirectoryStore("data")
r = zarr.open_group(store=store)
z = r.full("myArray", 42, shape=(), dtype="i4", compressor=None)

print(z.oindex[...])

0 comments on commit 03dd2ef

Please sign in to comment.