From ce740aa95817fc5e876d553744f5ed9df46ba2ec Mon Sep 17 00:00:00 2001 From: Joseph Hamman Date: Wed, 21 Aug 2024 15:14:09 -0700 Subject: [PATCH 1/3] clarify that the abstract store api is not normative --- docs/v3/core/v3.0.rst | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/v3/core/v3.0.rst b/docs/v3/core/v3.0.rst index d7366a79..732f68b3 100644 --- a/docs/v3/core/v3.0.rst +++ b/docs/v3/core/v3.0.rst @@ -1273,6 +1273,8 @@ when opening a Zarr hierarchy to automatically determine the appropriate store. Abstract store interface ------------------------ +(This subsection is not normative.) + The store interface is intended to be simple to implement using a variety of different underlying storage technologies. It is defined in a general way here, but it should be straightforward to translate into From 10e08bed1bcf72bf2b625a3036e76288bb4eb865 Mon Sep 17 00:00:00 2001 From: Joseph Hamman Date: Thu, 22 Aug 2024 16:05:08 -0700 Subject: [PATCH 2/3] remove language about store implementation requirements --- docs/v3/core/v3.0.rst | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/docs/v3/core/v3.0.rst b/docs/v3/core/v3.0.rst index 732f68b3..57071f65 100644 --- a/docs/v3/core/v3.0.rst +++ b/docs/v3/core/v3.0.rst @@ -1258,9 +1258,7 @@ Stores ====== A Zarr store is a system that can be used to store and retrieve data -from a Zarr hierarchy. For a store to be compatible with this -specification, it must support a set of operations defined in the `Abstract store -interface`_ subsection. The store interface can be implemented using a +from a Zarr hierarchy. The store interface can be implemented using a variety of underlying storage technologies, described in the subsection on `Store implementations`_. From f6cbfb79257bc6ed0d9687a5e73c30c9d566226d Mon Sep 17 00:00:00 2001 From: Joe Hamman Date: Mon, 16 Dec 2024 15:04:44 -0800 Subject: [PATCH 3/3] Update docs/v3/core/v3.0.rst Co-authored-by: Tom Nicholas --- docs/v3/core/v3.0.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/v3/core/v3.0.rst b/docs/v3/core/v3.0.rst index 57071f65..1479a8ba 100644 --- a/docs/v3/core/v3.0.rst +++ b/docs/v3/core/v3.0.rst @@ -1271,7 +1271,7 @@ when opening a Zarr hierarchy to automatically determine the appropriate store. Abstract store interface ------------------------ -(This subsection is not normative.) +(This subsection is not normative. It is intended only as a recommendation for API design, but does not need to be strictly followed like the specification for the on-disk storage does.) The store interface is intended to be simple to implement using a variety of different underlying storage technologies. It is defined in