From a6cb3ca33a58be945168e2379598a7d894a270df Mon Sep 17 00:00:00 2001
From: Tommaso Comparin <3862206+tcompa@users.noreply.github.com>
Date: Tue, 17 Oct 2023 13:48:18 +0200
Subject: [PATCH 1/3] Use "may" for `_ARRAY_DIMENSIONS` image attribute in v0.4
 (ref #217)

---
 0.4/index.bs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/0.4/index.bs b/0.4/index.bs
index b92f2ddb..dbbc9f13 100644
--- a/0.4/index.bs
+++ b/0.4/index.bs
@@ -145,7 +145,7 @@ For this example we assume an image with 5 dimensions and axes called `t,c,z,y,x
     ├── .zgroup               # Each image is a Zarr group, or a folder, of other groups and arrays.
     ├── .zattrs               # Group level attributes are stored in the .zattrs file and include
     │                         # "multiscales" and "omero" (see below). In addition, the group level attributes
-    │                         # must also contain "_ARRAY_DIMENSIONS" if this group directly contains multi-scale arrays.
+    │                         # may also contain "_ARRAY_DIMENSIONS" if this group directly contains multi-scale arrays.
     │
     ├── 0                     # Each multiscale level is stored as a separate Zarr array,
     │   ...                   # which is a folder containing chunk files which compose the array.

From ac4355841c89ab1438dcb84992e59e3a5127b41e Mon Sep 17 00:00:00 2001
From: Tommaso Comparin <3862206+tcompa@users.noreply.github.com>
Date: Tue, 17 Oct 2023 13:48:25 +0200
Subject: [PATCH 2/3] Use "may" for `_ARRAY_DIMENSIONS` image attribute in
 latest (ref #217)

---
 latest/index.bs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/latest/index.bs b/latest/index.bs
index bb42932e..b97a0911 100644
--- a/latest/index.bs
+++ b/latest/index.bs
@@ -93,7 +93,7 @@ For this example we assume an image with 5 dimensions and axes called `t,c,z,y,x
     ├── .zgroup               # Each image is a Zarr group, or a folder, of other groups and arrays.
     ├── .zattrs               # Group level attributes are stored in the .zattrs file and include
     │                         # "multiscales" and "omero" (see below). In addition, the group level attributes
-    │                         # must also contain "_ARRAY_DIMENSIONS" if this group directly contains multi-scale arrays.
+    │                         # may also contain "_ARRAY_DIMENSIONS" if this group directly contains multi-scale arrays.
     │
     ├── 0                     # Each multiscale level is stored as a separate Zarr array,
     │   ...                   # which is a folder containing chunk files which compose the array.

From 3fca4de96356213d9538dcc8bef688385c2bc703 Mon Sep 17 00:00:00 2001
From: Tommaso Comparin <3862206+tcompa@users.noreply.github.com>
Date: Tue, 17 Oct 2023 13:51:12 +0200
Subject: [PATCH 3/3] Add reference to xarray compatibility (re:
 `_ARRAY_DIMENSIONS`, ref #217)

---
 0.4/index.bs    | 2 +-
 latest/index.bs | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/0.4/index.bs b/0.4/index.bs
index dbbc9f13..a2df9c05 100644
--- a/0.4/index.bs
+++ b/0.4/index.bs
@@ -145,7 +145,7 @@ For this example we assume an image with 5 dimensions and axes called `t,c,z,y,x
     ├── .zgroup               # Each image is a Zarr group, or a folder, of other groups and arrays.
     ├── .zattrs               # Group level attributes are stored in the .zattrs file and include
     │                         # "multiscales" and "omero" (see below). In addition, the group level attributes
-    │                         # may also contain "_ARRAY_DIMENSIONS" if this group directly contains multi-scale arrays.
+    │                         # may also contain "_ARRAY_DIMENSIONS" for compatibility with xarray if this group directly contains multi-scale arrays.
     │
     ├── 0                     # Each multiscale level is stored as a separate Zarr array,
     │   ...                   # which is a folder containing chunk files which compose the array.
diff --git a/latest/index.bs b/latest/index.bs
index b97a0911..8d73c405 100644
--- a/latest/index.bs
+++ b/latest/index.bs
@@ -93,7 +93,7 @@ For this example we assume an image with 5 dimensions and axes called `t,c,z,y,x
     ├── .zgroup               # Each image is a Zarr group, or a folder, of other groups and arrays.
     ├── .zattrs               # Group level attributes are stored in the .zattrs file and include
     │                         # "multiscales" and "omero" (see below). In addition, the group level attributes
-    │                         # may also contain "_ARRAY_DIMENSIONS" if this group directly contains multi-scale arrays.
+    │                         # may also contain "_ARRAY_DIMENSIONS" for compatibility with xarray if this group directly contains multi-scale arrays.
     │
     ├── 0                     # Each multiscale level is stored as a separate Zarr array,
     │   ...                   # which is a folder containing chunk files which compose the array.