From b85178d1636174c8c76f7650255fc3299dc5e911 Mon Sep 17 00:00:00 2001
From: Josh Moore <josh@glencoesoftware.com>
Date: Thu, 20 Oct 2022 20:59:08 +0000
Subject: [PATCH] chore(rebuild): Merge pull request #112 from joshmoore/bf2raw

bioformats2raw.layout

SHA: 449fbca8a9d3fa7489e2e24039dc15a26ab3338d
Reason: push, by @thewtex

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
---
 0.1/index.html                     |   8 +-
 0.1/schemas/image.schema           | 112 ++++
 0.1/schemas/plate.schema           | 112 ++++
 0.1/schemas/strict_image.schema    |  19 +
 0.1/schemas/well.schema            |  47 ++
 0.2/index.html                     |   8 +-
 0.2/schemas/image.schema           | 101 ++++
 0.2/schemas/plate.schema           | 119 ++++
 0.2/schemas/well.schema            |  47 ++
 0.3/index.html                     |   8 +-
 0.3/schemas/image.schema           | 109 ++++
 0.3/schemas/plate.schema           | 119 ++++
 0.3/schemas/strict_image.schema    |  19 +
 0.3/schemas/well.schema            |  47 ++
 0.4/index.html                     | 838 +++++++++++++++----------
 0.4/schemas/image.schema           | 233 +++++++
 0.4/schemas/label.schema           |  77 +++
 0.4/schemas/plate.schema           | 140 +++++
 0.4/schemas/strict_image.schema    |  19 +
 0.4/schemas/strict_label.schema    |  18 +
 0.4/schemas/strict_plate.schema    |  28 +
 0.4/schemas/strict_well.schema     |  17 +
 0.4/schemas/well.schema            |  47 ++
 latest/index.html                  | 942 ++++++++++++++++++-----------
 latest/schemas/image.schema        | 233 +++++++
 latest/schemas/label.schema        |  77 +++
 latest/schemas/plate.schema        | 140 +++++
 latest/schemas/strict_image.schema |  19 +
 latest/schemas/strict_label.schema |  18 +
 latest/schemas/strict_plate.schema |  28 +
 latest/schemas/strict_well.schema  |  17 +
 latest/schemas/well.schema         |  47 ++
 32 files changed, 3146 insertions(+), 667 deletions(-)
 create mode 100644 0.1/schemas/image.schema
 create mode 100644 0.1/schemas/plate.schema
 create mode 100644 0.1/schemas/strict_image.schema
 create mode 100644 0.1/schemas/well.schema
 create mode 100644 0.2/schemas/image.schema
 create mode 100644 0.2/schemas/plate.schema
 create mode 100644 0.2/schemas/well.schema
 create mode 100644 0.3/schemas/image.schema
 create mode 100644 0.3/schemas/plate.schema
 create mode 100644 0.3/schemas/strict_image.schema
 create mode 100644 0.3/schemas/well.schema
 create mode 100644 0.4/schemas/image.schema
 create mode 100644 0.4/schemas/label.schema
 create mode 100644 0.4/schemas/plate.schema
 create mode 100644 0.4/schemas/strict_image.schema
 create mode 100644 0.4/schemas/strict_label.schema
 create mode 100644 0.4/schemas/strict_plate.schema
 create mode 100644 0.4/schemas/strict_well.schema
 create mode 100644 0.4/schemas/well.schema
 create mode 100644 latest/schemas/image.schema
 create mode 100644 latest/schemas/label.schema
 create mode 100644 latest/schemas/plate.schema
 create mode 100644 latest/schemas/strict_image.schema
 create mode 100644 latest/schemas/strict_label.schema
 create mode 100644 latest/schemas/strict_plate.schema
 create mode 100644 latest/schemas/strict_well.schema
 create mode 100644 latest/schemas/well.schema

diff --git a/0.1/index.html b/0.1/index.html
index 5fd854a5..81f67b8d 100644
--- a/0.1/index.html
+++ b/0.1/index.html
@@ -1487,9 +1487,9 @@
 		}
 	}
 </style>
-  <meta content="Bikeshed version fb1e763a4, updated Tue Mar 1 13:13:50 2022 -0800" name="generator">
+  <meta content="Bikeshed version b0de3432c, updated Thu Oct 13 09:16:59 2022 -0700" name="generator">
   <link href="https://ngff.openmicroscopy.org/0.1/" rel="canonical">
-  <meta content="8dec6918ee6630f43f339b281b66043e0a797ca4" name="document-revision">
+  <meta content="449fbca8a9d3fa7489e2e24039dc15a26ab3338d" name="document-revision">
 <style>/* style-autolinks */
 
 .css.css, .property.property, .descriptor.descriptor {
@@ -1825,7 +1825,7 @@
   <div class="head">
     <img alt="OME logo (6 circles in a hexagon)" src="http://www.openmicroscopy.org/img/logos/ome-logomark.svg" style="float:right;width:42px;height:42px;"> 
    <h1 class="p-name no-ref" id="title">Next-generation file formats (NGFF)</h1>
-   <h2 class="no-num no-toc no-ref heading settled" id="subtitle"><span class="content">Final Community Group Report, <time class="dt-updated" datetime="2022-03-18">18 March 2022</time></span></h2>
+   <h2 class="no-num no-toc no-ref heading settled" id="subtitle"><span class="content">Final Community Group Report, <time class="dt-updated" datetime="2022-10-20">20 October 2022</time></span></h2>
    <div data-fill-with="spec-metadata">
     <dl>
      <dt>This version:
@@ -2361,7 +2361,7 @@ <h3 class="no-ref no-num heading settled" id="w3c-conventions"><span class="cont
     and are set apart from the normative text
     with <code>class="note"</code>,
     like this: </p>
-   <p class="note" role="note">Note, this is an informative note. </p>
+   <p class="note" role="note">Note, this is an informative note.</p>
    <h3 class="no-ref no-num heading settled" id="w3c-conformant-algorithms"><span class="content">Conformant Algorithms</span><a class="self-link" href="#w3c-conformant-algorithms"></a></h3>
    <p>Requirements phrased in the imperative as part of algorithms
     (such as "strip any leading space characters"
diff --git a/0.1/schemas/image.schema b/0.1/schemas/image.schema
new file mode 100644
index 00000000..5a97f3f2
--- /dev/null
+++ b/0.1/schemas/image.schema
@@ -0,0 +1,112 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://ngff.openmicroscopy.org/0.1/schemas/image.schema",
+  "title": "NGFF Image",
+  "description": "JSON from OME-NGFF .zattrs",
+  "type": "object",
+  "properties": {
+    "multiscales": {
+      "description": "The multiscale datasets for this image",
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string"
+          },
+          "datasets": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+              "type": "object",
+              "properties": {
+                "path": {
+                  "type": "string"
+                }
+              },
+              "required": ["path"]
+            }
+          },
+          "version": {
+            "type": "string",
+            "enum": [
+              "0.1"
+            ]
+          },
+          "metadata": {
+            "type": "object",
+            "properties": {
+              "method": {
+                "type": "string"
+              },
+              "version": {
+                "type": "string"
+              }
+            }
+          }
+        },
+        "required": [
+          "datasets"
+        ]
+      },
+      "minItems": 1,
+      "uniqueItems": true
+    },
+    "omero": {
+      "type": "object",
+      "properties": {
+        "channels": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "window": {
+                "type": "object",
+                "properties": {
+                  "end": {
+                    "type": "number"
+                  },
+                  "max": {
+                    "type": "number"
+                  },
+                  "min": {
+                    "type": "number"
+                  },
+                  "start": {
+                    "type": "number"
+                  }
+                },
+                "required": [
+                  "start",
+                  "min",
+                  "end",
+                  "max"
+                ]
+              },
+              "label": {
+                "type": "string"
+              },
+              "family": {
+                "type": "string"
+              },
+              "color": {
+                "type": "string"
+              },
+              "active": {
+                "type": "boolean"
+              }
+            },
+            "required": [
+              "window",
+              "color"
+            ]
+          }
+        }
+      },
+      "required": [
+        "channels"
+      ]
+    }
+  },
+  "required": [ "multiscales" ]
+}
diff --git a/0.1/schemas/plate.schema b/0.1/schemas/plate.schema
new file mode 100644
index 00000000..e4f4f6f7
--- /dev/null
+++ b/0.1/schemas/plate.schema
@@ -0,0 +1,112 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://ngff.openmicroscopy.org/0.1/schemas/plate.schema",
+  "title": "OME-NGFF plate schema",
+  "description": "JSON from OME-NGFF Plate .zattrs",
+  "type": "object",
+  "properties": {
+    "plate": {
+      "type": "object",
+      "properties": {
+        "version": {
+          "type": "string",
+          "enum": [
+            "0.1"
+          ]
+        },
+        "name": {
+          "type": "string"
+        },
+        "columns": {
+          "description": "Columns of the Plate grid",
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "name": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "name"
+            ]
+          },
+          "minItems": 1,
+          "uniqueItems": true
+        },
+        "rows": {
+          "description": "Rows of the Plate grid",
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "name": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "name"
+            ]
+          },
+          "minItems": 1,
+          "uniqueItems": true
+        },
+        "wells": {
+          "description": "Rows of the Plate grid",
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "path": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "path"
+            ]
+          },
+          "minItems": 1,
+          "uniqueItems": true
+        },
+        "field_count": {
+          "description": "Maximum number of fields per view across all wells."
+        },
+        "acquisitions": {
+          "description": "Rows of the Plate grid",
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "number"
+              },
+              "maximumfieldcount": {
+                "type": "number"
+              },
+              "name": {
+                "type": "string"
+              },
+              "description": {
+                "type": "string"
+              },
+              "starttime": {
+                "type": "number"
+              }
+            },
+            "required": [
+              "id"
+            ]
+          },
+          "minItems": 1,
+          "uniqueItems": true
+        }
+      },
+      "required": [
+        "version", "columns", "rows", "wells"
+      ]
+    }
+  },
+  "required": [
+    "plate"
+  ]
+}
\ No newline at end of file
diff --git a/0.1/schemas/strict_image.schema b/0.1/schemas/strict_image.schema
new file mode 100644
index 00000000..ac375073
--- /dev/null
+++ b/0.1/schemas/strict_image.schema
@@ -0,0 +1,19 @@
+{
+  "$id": "https://ngff.openmicroscopy.org/0.1/schemas/strict_image.schema",
+  "allOf": [
+    {
+      "$ref": "https://ngff.openmicroscopy.org/0.1/schemas/image.schema"
+    },
+    {
+      "properties": {
+        "multiscales": {
+          "items": {
+            "required": [
+              "version", "metadata", "type", "name"
+            ]
+          }
+        }
+      }
+    }
+  ]
+}
\ No newline at end of file
diff --git a/0.1/schemas/well.schema b/0.1/schemas/well.schema
new file mode 100644
index 00000000..02475934
--- /dev/null
+++ b/0.1/schemas/well.schema
@@ -0,0 +1,47 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://ngff.openmicroscopy.org/0.1/schemas/well.schema",
+  "title": "OME-NGFF well schema",
+  "description": "JSON from OME-NGFF .zattrs",
+  "type": "object",
+  "properties": {
+    "well": {
+      "type": "object",
+      "properties": {
+        "images": {
+          "description": "The fields of view for this well",
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "acquisition": {
+                "description": "A unique identifier within the context of the plate",
+                "type": "integer"
+              },
+              "path": {
+                "description": "The path for this field of view subgroup",
+                "type": "string",
+                "pattern": "^[A-Za-z0-9]+$"
+              }
+            },
+            "required": [
+              "path"
+            ]
+          },
+          "minItems": 1,
+          "uniqueItems": true
+        },
+        "version": {
+          "description": "The version of the specification",
+          "type": "string",
+          "enum": [
+            "0.1"
+          ]
+        }
+      },
+      "required": [
+        "images"
+      ]
+    }
+  }
+}
diff --git a/0.2/index.html b/0.2/index.html
index 63777f41..0e3d4358 100644
--- a/0.2/index.html
+++ b/0.2/index.html
@@ -1487,9 +1487,9 @@
 		}
 	}
 </style>
-  <meta content="Bikeshed version fb1e763a4, updated Tue Mar 1 13:13:50 2022 -0800" name="generator">
+  <meta content="Bikeshed version b0de3432c, updated Thu Oct 13 09:16:59 2022 -0700" name="generator">
   <link href="https://ngff.openmicroscopy.org/0.2/" rel="canonical">
-  <meta content="8dec6918ee6630f43f339b281b66043e0a797ca4" name="document-revision">
+  <meta content="449fbca8a9d3fa7489e2e24039dc15a26ab3338d" name="document-revision">
 <style>/* style-autolinks */
 
 .css.css, .property.property, .descriptor.descriptor {
@@ -1825,7 +1825,7 @@
   <div class="head">
     <img alt="OME logo (6 circles in a hexagon)" src="http://www.openmicroscopy.org/img/logos/ome-logomark.svg" style="float:right;width:42px;height:42px;"> 
    <h1 class="p-name no-ref" id="title">Next-generation file formats (NGFF)</h1>
-   <h2 class="no-num no-toc no-ref heading settled" id="subtitle"><span class="content">Final Community Group Report, <time class="dt-updated" datetime="2022-03-18">18 March 2022</time></span></h2>
+   <h2 class="no-num no-toc no-ref heading settled" id="subtitle"><span class="content">Final Community Group Report, <time class="dt-updated" datetime="2022-10-20">20 October 2022</time></span></h2>
    <div data-fill-with="spec-metadata">
     <dl>
      <dt>This version:
@@ -2413,7 +2413,7 @@ <h3 class="no-ref no-num heading settled" id="w3c-conventions"><span class="cont
     and are set apart from the normative text
     with <code>class="note"</code>,
     like this: </p>
-   <p class="note" role="note">Note, this is an informative note. </p>
+   <p class="note" role="note">Note, this is an informative note.</p>
    <h3 class="no-ref no-num heading settled" id="w3c-conformant-algorithms"><span class="content">Conformant Algorithms</span><a class="self-link" href="#w3c-conformant-algorithms"></a></h3>
    <p>Requirements phrased in the imperative as part of algorithms
     (such as "strip any leading space characters"
diff --git a/0.2/schemas/image.schema b/0.2/schemas/image.schema
new file mode 100644
index 00000000..6eb26274
--- /dev/null
+++ b/0.2/schemas/image.schema
@@ -0,0 +1,101 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "http://localhost:8000/image.schema",
+  "title": "NGFF Image",
+  "description": "JSON from OME-NGFF .zattrs",
+  "type": "object",
+  "properties": {
+    "multiscales": {
+      "description": "The multiscale datasets for this image",
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string"
+          },
+          "datasets": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+              "type": "object",
+              "properties": {
+                "path": {
+                  "type": "string"
+                }
+              },
+              "required": ["path"]
+            }
+          },
+          "version": {
+            "type": "string",
+            "enum": [
+              "0.2"
+            ]
+          }
+        },
+        "required": [
+          "datasets"
+        ]
+      },
+      "minItems": 1,
+      "uniqueItems": true
+    },
+    "omero": {
+      "type": "object",
+      "properties": {
+        "channels": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "window": {
+                "type": "object",
+                "properties": {
+                  "end": {
+                    "type": "number"
+                  },
+                  "max": {
+                    "type": "number"
+                  },
+                  "min": {
+                    "type": "number"
+                  },
+                  "start": {
+                    "type": "number"
+                  }
+                },
+                "required": [
+                  "start",
+                  "min",
+                  "end",
+                  "max"
+                ]
+              },
+              "label": {
+                "type": "string"
+              },
+              "family": {
+                "type": "string"
+              },
+              "color": {
+                "type": "string"
+              },
+              "active": {
+                "type": "boolean"
+              }
+            },
+            "required": [
+              "window",
+              "color"
+            ]
+          }
+        }
+      },
+      "required": [
+        "channels"
+      ]
+    }
+  },
+  "required": [ "multiscales" ]
+}
diff --git a/0.2/schemas/plate.schema b/0.2/schemas/plate.schema
new file mode 100644
index 00000000..e30b1662
--- /dev/null
+++ b/0.2/schemas/plate.schema
@@ -0,0 +1,119 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://ngff.openmicroscopy.org/0.2/schemas/plate.schema",
+  "title": "OME-NGFF plate schema",
+  "description": "JSON from OME-NGFF Plate .zattrs",
+  "type": "object",
+  "properties": {
+    "plate": {
+      "type": "object",
+      "properties": {
+        "version": {
+          "type": "string",
+          "enum": [
+            "0.2"
+          ]
+        },
+        "name": {
+          "type": "string"
+        },
+        "columns": {
+          "description": "Columns of the Plate grid",
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "name": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "name"
+            ]
+          },
+          "minItems": 1,
+          "uniqueItems": true
+        },
+        "rows": {
+          "description": "Rows of the Plate grid",
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "name": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "name"
+            ]
+          },
+          "minItems": 1,
+          "uniqueItems": true
+        },
+        "wells": {
+          "description": "Rows of the Plate grid",
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "path": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "path"
+            ]
+          },
+          "minItems": 1,
+          "uniqueItems": true
+        },
+        "field_count": {
+          "description": "Maximum number of fields per view across all wells."
+        },
+        "acquisitions": {
+          "description": "Rows of the Plate grid",
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "integer"
+              },
+              "maximumfieldcount": {
+                "type": "integer"
+              },
+              "name": {
+                "type": "string"
+              },
+              "description": {
+                "type": "string"
+              },
+              "starttime": {
+                "description": "The start timestamp of the acquisition, expressed as epoch time i.e. the number seconds since the Epoch",
+                "type": "integer",
+                "minimum": 0
+              },
+              "endtime": {
+                "description": "The end timestamp of the acquisition, expressed as epoch time i.e. the number seconds since the Epoch",
+                "type": "integer",
+                "minimum": 0
+              }
+            },
+            "required": [
+              "id"
+            ]
+          },
+          "minItems": 1,
+          "uniqueItems": true
+        }
+      },
+      "required": [
+        "version", "columns", "rows", "wells"
+      ]
+    }
+  },
+  "required": [
+    "plate"
+  ]
+}
\ No newline at end of file
diff --git a/0.2/schemas/well.schema b/0.2/schemas/well.schema
new file mode 100644
index 00000000..8dca3290
--- /dev/null
+++ b/0.2/schemas/well.schema
@@ -0,0 +1,47 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://ngff.openmicroscopy.org/0.2/schemas/well.schema",
+  "title": "OME-NGFF well schema",
+  "description": "JSON from OME-NGFF .zattrs",
+  "type": "object",
+  "properties": {
+    "well": {
+      "type": "object",
+      "properties": {
+        "images": {
+          "description": "The fields of view for this well",
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "acquisition": {
+                "description": "A unique identifier within the context of the plate",
+                "type": "integer"
+              },
+              "path": {
+                "description": "The path for this field of view subgroup",
+                "type": "string",
+                "pattern": "^[A-Za-z0-9]+$"
+              }
+            },
+            "required": [
+              "path"
+            ]
+          },
+          "minItems": 1,
+          "uniqueItems": true
+        },
+        "version": {
+          "description": "The version of the specification",
+          "type": "string",
+          "enum": [
+            "0.2"
+          ]
+        }
+      },
+      "required": [
+        "images"
+      ]
+    }
+  }
+}
diff --git a/0.3/index.html b/0.3/index.html
index 62e2b9fe..d5841cc0 100644
--- a/0.3/index.html
+++ b/0.3/index.html
@@ -6,9 +6,9 @@
   <meta content="w3c/CG-FINAL" name="w3c-status">
   <link href="https://www.w3.org/StyleSheets/TR/2021/cg-final" rel="stylesheet">
   <link href="https://www.w3.org/2008/site/images/favicon.ico" rel="icon">
-  <meta content="Bikeshed version fb1e763a4, updated Tue Mar 1 13:13:50 2022 -0800" name="generator">
+  <meta content="Bikeshed version b0de3432c, updated Thu Oct 13 09:16:59 2022 -0700" name="generator">
   <link href="https://ngff.openmicroscopy.org/0.3/" rel="canonical">
-  <meta content="8dec6918ee6630f43f339b281b66043e0a797ca4" name="document-revision">
+  <meta content="449fbca8a9d3fa7489e2e24039dc15a26ab3338d" name="document-revision">
 <style>/* style-autolinks */
 
 .css.css, .property.property, .descriptor.descriptor {
@@ -344,7 +344,7 @@
   <div class="head">
    <p data-fill-with="logo"><a class="logo" href="https://www.w3.org/"> <img alt="W3C" height="48" src="https://www.w3.org/StyleSheets/TR/2021/logos/W3C" width="72"> </a> </p>
    <h1 class="p-name no-ref" id="title">Next-generation file formats (NGFF)</h1>
-   <p id="w3c-state"><a href="https://www.w3.org/standards/types#CG-FINAL">Final Community Group Report</a>, <time class="dt-updated" datetime="2022-03-18">18 March 2022</time></p>
+   <p id="w3c-state"><a href="https://www.w3.org/standards/types#CG-FINAL">Final Community Group Report</a>, <time class="dt-updated" datetime="2022-10-20">20 October 2022</time></p>
    <details open>
     <summary>More details about this document</summary>
     <div data-fill-with="spec-metadata">
@@ -948,7 +948,7 @@ <h3 class="no-ref no-num heading settled" id="w3c-conventions"><span class="cont
     and are set apart from the normative text
     with <code>class="note"</code>,
     like this: </p>
-   <p class="note" role="note">Note, this is an informative note. </p>
+   <p class="note" role="note">Note, this is an informative note.</p>
    <h3 class="no-ref no-num heading settled" id="w3c-conformant-algorithms"><span class="content">Conformant Algorithms</span><a class="self-link" href="#w3c-conformant-algorithms"></a></h3>
    <p>Requirements phrased in the imperative as part of algorithms
     (such as "strip any leading space characters"
diff --git a/0.3/schemas/image.schema b/0.3/schemas/image.schema
new file mode 100644
index 00000000..afc2bd16
--- /dev/null
+++ b/0.3/schemas/image.schema
@@ -0,0 +1,109 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://ngff.openmicroscopy.org/0.3/schemas/image.schema",
+  "title": "NGFF Image",
+  "description": "JSON from OME-NGFF .zattrs",
+  "type": "object",
+  "properties": {
+    "multiscales": {
+      "description": "The multiscale datasets for this image",
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string"
+          },
+          "datasets": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+              "type": "object",
+              "properties": {
+                "path": {
+                  "type": "string"
+                }
+              },
+              "required": ["path"]
+            }
+          },
+          "version": {
+            "type": "string",
+            "enum": [
+              "0.3"
+            ]
+          },
+          "axes": {
+            "type": "array",
+            "minItems": 2,
+            "items": {
+              "type": "string",
+              "pattern": "^[xyzct]$"
+            }
+          }
+        },
+        "required": [
+          "datasets", "axes"
+        ]
+      },
+      "minItems": 1,
+      "uniqueItems": true
+    },
+    "omero": {
+      "type": "object",
+      "properties": {
+        "channels": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "window": {
+                "type": "object",
+                "properties": {
+                  "end": {
+                    "type": "number"
+                  },
+                  "max": {
+                    "type": "number"
+                  },
+                  "min": {
+                    "type": "number"
+                  },
+                  "start": {
+                    "type": "number"
+                  }
+                },
+                "required": [
+                  "start",
+                  "min",
+                  "end",
+                  "max"
+                ]
+              },
+              "label": {
+                "type": "string"
+              },
+              "family": {
+                "type": "string"
+              },
+              "color": {
+                "type": "string"
+              },
+              "active": {
+                "type": "boolean"
+              }
+            },
+            "required": [
+              "window",
+              "color"
+            ]
+          }
+        }
+      },
+      "required": [
+        "channels"
+      ]
+    }
+  },
+  "required": [ "multiscales" ]
+}
diff --git a/0.3/schemas/plate.schema b/0.3/schemas/plate.schema
new file mode 100644
index 00000000..1222d895
--- /dev/null
+++ b/0.3/schemas/plate.schema
@@ -0,0 +1,119 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://ngff.openmicroscopy.org/0.3/schemas/plate.schema",
+  "title": "NGFF Plate",
+  "description": "JSON from OME-NGFF Plate .zattrs",
+  "type": "object",
+  "properties": {
+    "plate": {
+      "type": "object",
+      "properties": {
+        "version": {
+          "type": "string",
+          "enum": [
+            "0.3"
+          ]
+        },
+        "name": {
+          "type": "string"
+        },
+        "columns": {
+          "description": "Columns of the Plate grid",
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "name": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "name"
+            ]
+          },
+          "minItems": 1,
+          "uniqueItems": true
+        },
+        "rows": {
+          "description": "Rows of the Plate grid",
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "name": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "name"
+            ]
+          },
+          "minItems": 1,
+          "uniqueItems": true
+        },
+        "wells": {
+          "description": "Rows of the Plate grid",
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "path": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "path"
+            ]
+          },
+          "minItems": 1,
+          "uniqueItems": true
+        },
+        "field_count": {
+          "description": "Maximum number of fields per view across all wells."
+        },
+        "acquisitions": {
+          "description": "Rows of the Plate grid",
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "integer"
+              },
+              "maximumfieldcount": {
+                "type": "integer"
+              },
+              "name": {
+                "type": "string"
+              },
+              "description": {
+                "type": "string"
+              },
+              "starttime": {
+                "description": "The start timestamp of the acquisition, expressed as epoch time i.e. the number seconds since the Epoch",
+                "type": "integer",
+                "minimum": 0
+              },
+              "endtime": {
+                "description": "The end timestamp of the acquisition, expressed as epoch time i.e. the number seconds since the Epoch",
+                "type": "integer",
+                "minimum": 0
+              }
+            },
+            "required": [
+              "id"
+            ]
+          },
+          "minItems": 1,
+          "uniqueItems": true
+        }
+      },
+      "required": [
+        "version", "columns", "rows", "wells"
+      ]
+    }
+  },
+  "required": [
+    "plate"
+  ]
+}
\ No newline at end of file
diff --git a/0.3/schemas/strict_image.schema b/0.3/schemas/strict_image.schema
new file mode 100644
index 00000000..5e16b2a4
--- /dev/null
+++ b/0.3/schemas/strict_image.schema
@@ -0,0 +1,19 @@
+{
+  "$id": "https://ngff.openmicroscopy.org/0.3/schemas/strict_image.schema",
+  "allOf": [
+    {
+      "$ref": "https://ngff.openmicroscopy.org/0.3/schemas/image.schema"
+    },
+    {
+      "properties": {
+        "multiscales": {
+          "items": {
+            "required": [
+              "version", "metadata", "type", "name"
+            ]
+          }
+        }
+      }
+    }
+  ]
+}
\ No newline at end of file
diff --git a/0.3/schemas/well.schema b/0.3/schemas/well.schema
new file mode 100644
index 00000000..b88bc745
--- /dev/null
+++ b/0.3/schemas/well.schema
@@ -0,0 +1,47 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://ngff.openmicroscopy.org/0.3/schemas/well.schema",
+  "title": "OME-NGFF well schema",
+  "description": "JSON from OME-NGFF .zattrs",
+  "type": "object",
+  "properties": {
+    "well": {
+      "type": "object",
+      "properties": {
+        "images": {
+          "description": "The fields of view for this well",
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "acquisition": {
+                "description": "A unique identifier within the context of the plate",
+                "type": "integer"
+              },
+              "path": {
+                "description": "The path for this field of view subgroup",
+                "type": "string",
+                "pattern": "^[A-Za-z0-9]+$"
+              }
+            },
+            "required": [
+              "path"
+            ]
+          },
+          "minItems": 1,
+          "uniqueItems": true
+        },
+        "version": {
+          "description": "The version of the specification",
+          "type": "string",
+          "enum": [
+            "0.3"
+          ]
+        }
+      },
+      "required": [
+        "images"
+      ]
+    }
+  }
+}
diff --git a/0.4/index.html b/0.4/index.html
index fd8777c8..447badb4 100644
--- a/0.4/index.html
+++ b/0.4/index.html
@@ -6,9 +6,9 @@
   <meta content="w3c/CG-FINAL" name="w3c-status">
   <link href="https://www.w3.org/StyleSheets/TR/2021/cg-final" rel="stylesheet">
   <link href="https://www.w3.org/2008/site/images/favicon.ico" rel="icon">
-  <meta content="Bikeshed version fb1e763a4, updated Tue Mar 1 13:13:50 2022 -0800" name="generator">
+  <meta content="Bikeshed version b0de3432c, updated Thu Oct 13 09:16:59 2022 -0700" name="generator">
   <link href="https://ngff.openmicroscopy.org/0.4/" rel="canonical">
-  <meta content="8dec6918ee6630f43f339b281b66043e0a797ca4" name="document-revision">
+  <meta content="449fbca8a9d3fa7489e2e24039dc15a26ab3338d" name="document-revision">
 <style>/* style-autolinks */
 
 .css.css, .property.property, .descriptor.descriptor {
@@ -209,6 +209,47 @@
 figcaption:not(.no-marker)::before {
     content: "Figure " counter(figure) " ";
 }</style>
+<style>/* style-dfn-panel */
+
+:root {
+    --dfnpanel-bg: #ddd;
+    --dfnpanel-text: var(--text);
+}
+.dfn-panel {
+    position: absolute;
+    z-index: 35;
+    height: auto;
+    width: -webkit-fit-content;
+    width: fit-content;
+    max-width: 300px;
+    max-height: 500px;
+    overflow: auto;
+    padding: 0.5em 0.75em;
+    font: small Helvetica Neue, sans-serif, Droid Sans Fallback;
+    background: var(--dfnpanel-bg);
+    color: var(--dfnpanel-text);
+    border: outset 0.2em;
+}
+.dfn-panel:not(.on) { display: none; }
+.dfn-panel * { margin: 0; padding: 0; text-indent: 0; }
+.dfn-panel > b { display: block; }
+.dfn-panel a { color: var(--dfnpanel-text); }
+.dfn-panel a:not(:hover) { text-decoration: none !important; border-bottom: none !important; }
+.dfn-panel > b + b { margin-top: 0.25em; }
+.dfn-panel ul { padding: 0; }
+.dfn-panel li { list-style: inside; }
+.dfn-panel.activated {
+    display: inline-block;
+    position: fixed;
+    left: .5em;
+    bottom: 2em;
+    margin: 0 auto;
+    max-width: calc(100vw - 1.5em - .4em - .5em);
+    max-height: 30vh;
+}
+
+.dfn-paneled { cursor: pointer; }
+</style>
 <style>/* style-issues */
 
 a[href].issue-return {
@@ -344,7 +385,7 @@
   <div class="head">
    <p data-fill-with="logo"><a class="logo" href="https://www.w3.org/"> <img alt="W3C" height="48" src="https://www.w3.org/StyleSheets/TR/2021/logos/W3C" width="72"> </a> </p>
    <h1 class="p-name no-ref" id="title">Next-generation file formats (NGFF)</h1>
-   <p id="w3c-state"><a href="https://www.w3.org/standards/types#CG-FINAL">Final Community Group Report</a>, <time class="dt-updated" datetime="2022-03-18">18 March 2022</time></p>
+   <p id="w3c-state"><a href="https://www.w3.org/standards/types#CG-FINAL">Final Community Group Report</a>, <time class="dt-updated" datetime="2022-10-20">20 October 2022</time></p>
    <details open>
     <summary>More details about this document</summary>
     <div data-fill-with="spec-metadata">
@@ -402,13 +443,14 @@ <h2 class="no-num no-toc no-ref" id="contents">Table of Contents</h2>
      <a href="#metadata"><span class="secno">3</span> <span class="content">Metadata</span></a>
      <ol class="toc">
       <li><a href="#axes-md"><span class="secno">3.1</span> <span class="content">"axes" metadata</span></a>
-      <li><a href="#trafo-md"><span class="secno">3.2</span> <span class="content">"coordinateTransformations" metadata</span></a>
-      <li><a href="#multiscale-md"><span class="secno">3.3</span> <span class="content">"multiscales" metadata</span></a>
-      <li><a href="#omero-md"><span class="secno">3.4</span> <span class="content">"omero" metadata</span></a>
-      <li><a href="#labels-md"><span class="secno">3.5</span> <span class="content">"labels" metadata</span></a>
-      <li><a href="#label-md"><span class="secno">3.6</span> <span class="content">"image-label" metadata</span></a>
-      <li><a href="#plate-md"><span class="secno">3.7</span> <span class="content">"plate" metadata</span></a>
-      <li><a href="#well-md"><span class="secno">3.8</span> <span class="content">"well" metadata</span></a>
+      <li><a href="#bf2raw"><span class="secno">3.2</span> <span class="content">"bioformats2raw.layout" (transitional)</span></a>
+      <li><a href="#trafo-md"><span class="secno">3.3</span> <span class="content">"coordinateTransformations" metadata</span></a>
+      <li><a href="#multiscale-md"><span class="secno">3.4</span> <span class="content">"multiscales" metadata</span></a>
+      <li><a href="#omero-md"><span class="secno">3.5</span> <span class="content">"omero" metadata (transitional)</span></a>
+      <li><a href="#labels-md"><span class="secno">3.6</span> <span class="content">"labels" metadata</span></a>
+      <li><a href="#label-md"><span class="secno">3.7</span> <span class="content">"image-label" metadata</span></a>
+      <li><a href="#plate-md"><span class="secno">3.8</span> <span class="content">"plate" metadata</span></a>
+      <li><a href="#well-md"><span class="secno">3.9</span> <span class="content">"well" metadata</span></a>
      </ol>
     <li><a href="#naming-style"><span class="secno">4</span> <span class="content">Specification naming style</span></a>
     <li><a href="#implementations"><span class="secno">5</span> <span class="content">Implementations</span></a>
@@ -486,6 +528,11 @@ <h3 class="heading settled" data-level="1.2" id="ome-ngff"><span class="secno">1
    <h3 class="heading settled" data-level="1.3" id="document-conventions"><span class="secno">1.3. </span><span class="content">Document conventions</span><a class="self-link" href="#document-conventions"></a></h3>
    <p>The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”,
 “RECOMMENDED”, “MAY”, and “OPTIONAL” are to be interpreted as described in <a href="https://tools.ietf.org/html/rfc2119">RFC 2119</a>.</p>
+   <p> <dfn class="dfn-paneled" data-dfn-type="dfn" data-noexport id="transitional">Transitional</dfn> metadata is added to the specification with the
+intention of removing it in the future. Implementations may be expected (MUST) or
+encouraged (SHOULD) to support the reading of the data, but writing will usually
+be optional (MAY). Examples of transitional metadata include custom additions by
+implementations that are later submitted as a formal specification. (See <a href="#bf2raw">§ 3.2 "bioformats2raw.layout" (transitional)</a>) </p>
    <p>Some of the JSON examples in this document include commments. However, these are only for
 clarity purposes and comments MUST NOT be included in JSON objects.</p>
    <h2 class="heading settled" data-level="2" id="on-disk"><span class="secno">2. </span><span class="content">On-disk (or in-cloud) layout</span><a class="self-link" href="#on-disk"></a></h2>
@@ -502,7 +549,7 @@ <h2 class="heading settled" data-level="2" id="on-disk"><span class="secno">2. <
    <h3 class="heading settled" data-level="2.1" id="image-layout"><span class="secno">2.1. </span><span class="content">Images</span><a class="self-link" href="#image-layout"></a></h3>
    <p>The following layout describes the expected Zarr hierarchy for images with
 multiple levels of resolutions and optionally associated labels.
-Note that the number of dimensions is variable between 2 and 5 and that axis names are arbitrary, see <a href="#multiscale-md">§ 3.3 "multiscales" metadata</a> for details.
+Note that the number of dimensions is variable between 2 and 5 and that axis names are arbitrary, see <a href="#multiscale-md">§ 3.4 "multiscales" metadata</a> for details.
 For this example we assume an image with 5 dimensions and axes called <code>t,c,z,y,x</code>.</p>
 <pre>.                             # Root folder, potentially in S3,
 │                             # with a flat list of images by image ID.
@@ -610,8 +657,120 @@ <h3 class="heading settled" data-level="3.1" id="axes-md"><span class="secno">3.
        <p>Units for "time" axes: <a class="property css" data-link-type="property">attosecond</a>, <a class="property css" data-link-type="property">centisecond</a>, <a class="property css" data-link-type="property">day</a>, <a class="property css" data-link-type="property">decisecond</a>, <a class="property css" data-link-type="property">exasecond</a>, <a class="property css" data-link-type="property">femtosecond</a>, <a class="property css" data-link-type="property">gigasecond</a>, <a class="property css" data-link-type="property">hectosecond</a>, <a class="property css" data-link-type="property">hour</a>, <a class="property css" data-link-type="property">kilosecond</a>, <a class="property css" data-link-type="property">megasecond</a>, <a class="property css" data-link-type="property">microsecond</a>, <a class="property css" data-link-type="property">millisecond</a>, <a class="property css" data-link-type="property">minute</a>, <a class="property css" data-link-type="property">nanosecond</a>, <a class="property css" data-link-type="property">petasecond</a>, <a class="property css" data-link-type="property">picosecond</a>, <a class="property css" data-link-type="property">second</a>, <a class="property css" data-link-type="property">terasecond</a>, <a class="property css" data-link-type="property">yoctosecond</a>, <a class="property css" data-link-type="property">yottasecond</a>, <a class="property css" data-link-type="property">zeptosecond</a>, <a class="property css" data-link-type="property">zettasecond</a></p>
      </ul>
    </ul>
-   <p>If part of <a href="#multiscale-md">§ 3.3 "multiscales" metadata</a>, the length of "axes" MUST be equal to the number of dimensions of the arrays that contain the image data.</p>
-   <h3 class="heading settled" data-level="3.2" id="trafo-md"><span class="secno">3.2. </span><span class="content">"coordinateTransformations" metadata</span><a class="self-link" href="#trafo-md"></a></h3>
+   <p>If part of <a href="#multiscale-md">§ 3.4 "multiscales" metadata</a>, the length of "axes" MUST be equal to the number of dimensions of the arrays that contain the image data.</p>
+   <h3 class="heading settled" data-level="3.2" id="bf2raw"><span class="secno">3.2. </span><span class="content">"bioformats2raw.layout" (transitional)</span><a class="self-link" href="#bf2raw"></a></h3>
+   <p><a data-link-type="dfn" href="#transitional" id="ref-for-transitional">Transitional</a> "bioformats2raw.layout" metadata identifies a group which implicitly describes a series of images.
+The need for the collection stems from the common "multi-image file" scenario in microscopy. Parsers like Bio-Formats
+define a strict, stable ordering of the images in a single container that can be used to refer to them by other tools.</p>
+   <p>In order to capture that information within an OME-NGFF dataset, <code>bioformats2raw</code> internally introduced a wrapping layer.
+The bioformats2raw layout has been added to v0.4 as a transitional specification to specify filesets that already exist
+in the wild. An upcoming NGFF specification will replace this layout with explicit metadata.</p>
+   <h4 class="no-toc heading settled" data-level="3.2.1" id="bf2raw-layout"><span class="secno">3.2.1. </span><span class="content">Layout</span><a class="self-link" href="#bf2raw-layout"></a></h4>
+   <p>Typical Zarr layout produced by running <code>bioformats2raw</code> on a fileset that contains more than one image (series > 1):</p>
+<pre>series.ome.zarr               # One converted fileset from bioformats2raw
+    ├── .zgroup
+    ├── .zattrs               # Contains "bioformats2raw.layout" metadata
+    ├── OME                   # Special group for containing OME metadata
+    │   ├── .zgroup
+    │   ├── .zattrs           # Contains "series" metadata
+    │   └── METADATA.ome.xml  # OME-XML file stored within the Zarr fileset
+    ├── 0                     # First image in the collection
+    ├── 1                     # Second image in the collection
+    └── ...
+</pre>
+   <h4 class="no-toc heading settled" data-level="3.2.2" id="bf2raw-attributes"><span class="secno">3.2.2. </span><span class="content">Attributes</span><a class="self-link" href="#bf2raw-attributes"></a></h4>
+   <p>The top-level <code>.zattrs</code> file must contain the <code>bioformats2raw.layout</code> key:</p>
+<pre class="include-code highlight"><c- p>{</c->
+  <c- f>"bioformats2raw.layout"</c-> <c- p>:</c-> <c- mi>3</c->
+<c- p>}</c-></pre>
+   <p>If the top-level group represents a plate, the <code>bioformats2raw.layout</code> metadata will be present but
+the "plate" key MUST also be present, takes precedence and parsing of such datasets should follow <a href="#plate-md">§ 3.8 "plate" metadata</a>. It is not
+possible to mix collections of images with plates at present.</p>
+<pre class="include-code highlight"><c- p>{</c->
+  <c- f>"bioformats2raw.layout"</c-> <c- p>:</c-> <c- mi>3</c-><c- p>,</c->
+  <c- f>"plate"</c-> <c- p>:</c-> <c- p>{</c->
+    <c- f>"columns"</c-> <c- p>:</c-> <c- p>[</c-> <c- p>{</c->
+      <c- f>"name"</c-> <c- p>:</c-> <c- u>"1"</c->
+    <c- p>}</c-> <c- p>],</c->
+    <c- f>"name"</c-> <c- p>:</c-> <c- u>"Plate Name 0"</c-><c- p>,</c->
+    <c- f>"wells"</c-> <c- p>:</c-> <c- p>[</c-> <c- p>{</c->
+      <c- f>"path"</c-> <c- p>:</c-> <c- u>"A/1"</c-><c- p>,</c->
+      <c- f>"rowIndex"</c-> <c- p>:</c-> <c- mi>0</c-><c- p>,</c->
+      <c- f>"columnIndex"</c-> <c- p>:</c-> <c- mi>0</c->
+    <c- p>}</c-> <c- p>],</c->
+    <c- f>"field_count"</c-> <c- p>:</c-> <c- mi>1</c-><c- p>,</c->
+    <c- f>"rows"</c-> <c- p>:</c-> <c- p>[</c-> <c- p>{</c->
+      <c- f>"name"</c-> <c- p>:</c-> <c- u>"A"</c->
+    <c- p>}</c-> <c- p>],</c->
+    <c- f>"acquisitions"</c-> <c- p>:</c-> <c- p>[</c-> <c- p>{</c->
+      <c- f>"id"</c-> <c- p>:</c-> <c- mi>0</c->
+    <c- p>}</c-> <c- p>],</c->
+    <c- f>"version"</c-> <c- p>:</c-> <c- u>"0.4"</c->
+  <c- p>}</c->
+<c- p>}</c->
+</pre>
+   <p>The <code>.zattrs</code> file within the OME group may contain the "series" key:</p>
+<pre class="include-code highlight"><c- p>{</c->
+  <c- f>"series"</c-> <c- p>:</c-> <c- p>[</c-> <c- u>"0"</c-><c- p>,</c-> <c- u>"1"</c-> <c- p>]</c->
+<c- p>}</c->
+</pre>
+   <h4 class="no-toc heading settled" data-level="3.2.3" id="bf2raw-details"><span class="secno">3.2.3. </span><span class="content">Details</span><a class="self-link" href="#bf2raw-details"></a></h4>
+   <p>Conforming groups:</p>
+   <ul>
+    <li data-md>
+     <p>MUST have the value "3" for the "bioformats2raw.layout" key in their <code>.zattrs</code> metadata at the top of the hierarchy;</p>
+    <li data-md>
+     <p>SHOULD have OME metadata representing the entire collection of images in a file named "OME/METADATA.ome.xml" which:</p>
+     <ul>
+      <li data-md>
+       <p>MUST adhere to the OME-XML specification but</p>
+      <li data-md>
+       <p>MUST use <code>&lt;MetadataOnly/></code> elements as opposed to <code>&lt;BinData/></code>, <code>&lt;BinaryOnly/></code> or <code>&lt;TiffData/></code>;</p>
+      <li data-md>
+       <p>MAY make use of the <a href="https://docs.openmicroscopy.org/ome-model/6.2.2/specifications/minimum.html">minimum specification</a>.</p>
+     </ul>
+   </ul>
+   <p>Additionally, the logic for finding the Zarr group for each image follows the following logic:</p>
+   <ul>
+    <li data-md>
+     <p>If "plate" metadata is present, images MUST be located at the defined location.</p>
+     <ul>
+      <li data-md>
+       <p>Matching "series" metadata (as described next) SHOULD be provided for tools that are unaware of the "plate" specification.</p>
+     </ul>
+    <li data-md>
+     <p>If the "OME" Zarr group exists, it:</p>
+     <ul>
+      <li data-md>
+       <p>MAY contain a "series" attribute. If so:</p>
+       <ul>
+        <li data-md>
+         <p>"series" MUST be a list of string objects, each of which is a path to an image group.</p>
+        <li data-md>
+         <p>The order of the paths MUST match the order of the "Image" elements in "OME/METADATA.ome.xml" if provided.</p>
+       </ul>
+     </ul>
+    <li data-md>
+     <p>If the "series" attribute does not exist and no "plate" is present:</p>
+     <ul>
+      <li data-md>
+       <p>separate "multiscales" images MUST be stored in consecutively numbered groups starting from 0 (i.e. "0/", "1/", "2/", "3/", ...).</p>
+     </ul>
+    <li data-md>
+     <p>Every "multiscales" group MUST represent exactly one OME-XML "Image" in the same order as either the series index or the group numbers.</p>
+   </ul>
+   <p>Conforming readers:</p>
+   <ul>
+    <li data-md>
+     <p>SHOULD make users aware of the presence of more than one image (i.e. SHOULD NOT default to only opening the first image);</p>
+    <li data-md>
+     <p>MAY use the "series" attribute in the "OME" group to determine a list of valid groups to display;</p>
+    <li data-md>
+     <p>MAY choose to show all images within the collection or offer the user a choice of images, as with <dfn data-dfn-type="dfn" data-export id="hcs"><abbr title="High-content screening">HCS</abbr><a class="self-link" href="#hcs"></a></dfn> plates;</p>
+    <li data-md>
+     <p>MAY ignore other groups or arrays under the root of the hierarchy.</p>
+   </ul>
+   <h3 class="heading settled" data-level="3.3" id="trafo-md"><span class="secno">3.3. </span><span class="content">"coordinateTransformations" metadata</span><a class="self-link" href="#trafo-md"></a></h3>
    <p>"coordinateTransformations" describe a series of transformations that map between two coordinate spaces (defined by "axes").
 For example, to map a discrete data space of an array to the corresponding physical space.
 It is a list of dictionaries. Each entry describes a single transformation and MUST contain the field "type".
@@ -638,7 +797,7 @@ <h3 class="heading settled" data-level="3.2" id="trafo-md"><span class="secno">3
       <th>description 
    </table>
    <p>The transformations in the list are applied sequentially and in order.</p>
-   <h3 class="heading settled" data-level="3.3" id="multiscale-md"><span class="secno">3.3. </span><span class="content">"multiscales" metadata</span><a class="self-link" href="#multiscale-md"></a></h3>
+   <h3 class="heading settled" data-level="3.4" id="multiscale-md"><span class="secno">3.4. </span><span class="content">"multiscales" metadata</span><a class="self-link" href="#multiscale-md"></a></h3>
    <p>Metadata about an image can be found under the "multiscales" key in the group-level metadata. Here, image refers to 2 to 5 dimensional data representing image or volumetric data with optional time or channel axes. It is stored in a multiple resolution representation.</p>
    <p>"multiscales" contains a list of dictionaries where each entry describes a multiscale image.</p>
    <p>Each "multiscales" dictionary MUST contain the field "axes", see <a href="#axes-md">§ 3.1 "axes" metadata</a>.
@@ -651,7 +810,7 @@ <h3 class="heading settled" data-level="3.3" id="multiscale-md"><span class="sec
 to the current zarr group. The "path"s MUST be ordered from largest (i.e. highest resolution) to smallest.</p>
    <p>Each "datasets" dictionary MUST have the same number of dimensions and MUST NOT have more than 5 dimensions. The number of dimensions and order MUST correspond to number and order of "axes".
 Each dictionary in "datasets" MUST contain the field "coordinateTransformations", which contains a list of transformations that map the data coordinates to the physical coordinates (as specified by "axes") for this resolution level.
-The transformations are defined according to <a href="#trafo-md">§ 3.2 "coordinateTransformations" metadata</a>. The transformation MUST only be of type <code>translation</code> or <code>scale</code>.
+The transformations are defined according to <a href="#trafo-md">§ 3.3 "coordinateTransformations" metadata</a>. The transformation MUST only be of type <code>translation</code> or <code>scale</code>.
 They MUST contain exactly one <code>scale</code> transformation that specifies the pixel size in physical units or time duration. If scaling information is not available or applicable for one of the axes, the value MUST express the scaling factor between the current resolution and the first resolution for the given axis, defaulting to 1.0 if there is no downsampling along the axis.
 It MAY contain exactly one <code>translation</code> that specifies the offset from the origin in physical units. If <code>translation</code> is given it MUST be listed after <code>scale</code> to ensure that it is given in physical coordinates.
 The length of the <code>scale</code> and <code>translation</code> array MUST be the same as the length of "axes".
@@ -727,8 +886,8 @@ <h3 class="heading settled" data-level="3.3" id="multiscale-md"><span class="sec
     <c- c1># Use the first by default. Or perhaps choose based on chunk size.</c->
     <c- n>datasets</c-> <c- o>=</c-> <c- p>[</c-><c- n>x</c-><c- p>[</c-><c- u>"path"</c-><c- p>]</c-> <c- k>for</c-> <c- n>x</c-> <c- ow>in</c-> <c- n>multiscales</c-><c- p>[</c-><c- mi>0</c-><c- p>][</c-><c- u>"datasets"</c-><c- p>]]</c->
 </pre>
-   <h3 class="heading settled" data-level="3.4" id="omero-md"><span class="secno">3.4. </span><span class="content">"omero" metadata</span><a class="self-link" href="#omero-md"></a></h3>
-   <p>Information specific to the channels of an image and how to render it
+   <h3 class="heading settled" data-level="3.5" id="omero-md"><span class="secno">3.5. </span><span class="content">"omero" metadata (transitional)</span><a class="self-link" href="#omero-md"></a></h3>
+   <p><a data-link-type="dfn" href="#transitional" id="ref-for-transitional①">Transitional</a> information specific to the channels of an image and how to render it
 can be found under the "omero" key in the group-level metadata:</p>
 <pre class="language-json highlight"><c- f>"id"</c-><c- p>:</c-> <c- mi>1</c-><c- p>,</c->                              # ID i<c- kc>n</c-> OMERO
 <c- f>"name"</c-><c- p>:</c-> <c- u>"example.tif"</c-><c- p>,</c->                # Name as show<c- kc>n</c-> i<c- kc>n</c-> <c- kc>t</c->he UI
@@ -757,7 +916,7 @@ <h3 class="heading settled" data-level="3.4" id="omero-md"><span class="secno">3
 </pre>
    <p>See https://docs.openmicroscopy.org/omero/5.6.1/developers/Web/WebGateway.html#imgdata
 for more information.</p>
-   <h3 class="heading settled" data-level="3.5" id="labels-md"><span class="secno">3.5. </span><span class="content">"labels" metadata</span><a class="self-link" href="#labels-md"></a></h3>
+   <h3 class="heading settled" data-level="3.6" id="labels-md"><span class="secno">3.6. </span><span class="content">"labels" metadata</span><a class="self-link" href="#labels-md"></a></h3>
    <p>The special group "labels" found under an image Zarr contains the key <code>labels</code> containing
 the paths to label objects which can be found underneath the group:</p>
 <pre class="language-json highlight"><c- p>{</c->
@@ -767,334 +926,330 @@ <h3 class="heading settled" data-level="3.5" id="labels-md"><span class="secno">
 <c- p>}</c->
 </pre>
    <p>Unlisted groups MAY be labels.</p>
-   <h3 class="heading settled" data-level="3.6" id="label-md"><span class="secno">3.6. </span><span class="content">"image-label" metadata</span><a class="self-link" href="#label-md"></a></h3>
+   <h3 class="heading settled" data-level="3.7" id="label-md"><span class="secno">3.7. </span><span class="content">"image-label" metadata</span><a class="self-link" href="#label-md"></a></h3>
    <p>Groups containing the <code>image-label</code> dictionary represent an image segmentation
 in which each unique pixel value represents a separate segmented object. <code>image-label</code> groups MUST also contain <code>multiscales</code> metadata and the two
 "datasets" series MUST have the same number of entries.</p>
-   <p>The <code>colors</code> key defines a list of JSON objects describing the unique label
-values. Each entry in the list MUST contain the key "label-value" with the
-pixel value for that label. Additionally, the "rgba" key MAY be present, the
-value for which is an RGBA unsigned-int 4-tuple: <code>[uint8, uint8, uint8, uint8]</code> All <code>label-value</code>s must be unique. Clients who choose to not throw an error
-should ignore all except the _last_ entry.</p>
-   <p>Some implementations may represent overlapping labels by using a specially assigned
+   <p>The <code>image-label</code> dictionary SHOULD contain a <code>colors</code> key whose value MUST be a
+list of JSON objects describing the unique label values. Each color object MUST
+contain the <code>label-value</code> key whose value MUST be an integer specifying the
+pixel value for that label. It MAY contain an <code>rgba</code> key whose value MUST be an array
+of four integers between 0 and 255 <code>[uint8, uint8, uint8, uint8]</code> specifying the label
+color as RGBA. All the values under the <code>label-value</code> key MUST be unique. Clients
+who choose to not throw an error SHOULD ignore all except the _last_ entry.</p>
+   <p>Some implementations MAY represent overlapping labels by using a specially assigned
 value, for example the highest integer available in the pixel range.</p>
-   <p>The <code>properties</code> key defines a list of JSON objects which also describes the unique
-label values. Each entry in the list MUST contain the key "label-value" with the
-pixel value for that label. Additionally, an arbitrary number of key-value pairs
+   <p>The <code>image-label</code> dictionary MAY contain a <code>properties</code> key whose value MUST be a
+list of JSON objects which also describes the unique label values. Each property object
+MUST contain the <code>label-value</code> key whose value MUST be an integer specifying the pixel
+value for that label. Additionally, an arbitrary number of key-value pairs
 MAY be present for each label value denoting associated metadata. Not all label
 values must share the same key-value pairs within the properties list.</p>
-   <p>The <code>source</code> key is an optional dictionary which contains information on the
-image the label is associated with. If included it MAY include a key <code>image</code> whose value is the relative path to a Zarr image group. The default value is
-"../../" since most labels are stored under a subgroup named "labels/" (see
-above).</p>
-<pre class="language-json highlight"><c- f>"image-label"</c-><c- p>:</c->
-  <c- p>{</c->
+   <p>The <code>image-label</code> dictionary MAY contain a <code>source</code> key whose value MUST be a JSON
+object containing information on the image the label is associated with. If included,
+it MAY include a key <code>image</code> whose value MUST be a string specifying the relative
+path to a Zarr image group. The default value is "../../" since most labels are stored
+under a subgroup named "labels/" (see above).</p>
+   <p>The <code>image-label</code> dictionary SHOULD contain a <code>version</code> key whose value MUST be a string
+specifying the version of the image-label specification.</p>
+<pre class="include-code highlight"><c- p>{</c->
+  <c- f>"image-label"</c-><c- p>:</c-> <c- p>{</c->
     <c- f>"version"</c-><c- p>:</c-> <c- u>"0.4"</c-><c- p>,</c->
     <c- f>"colors"</c-><c- p>:</c-> <c- p>[</c->
       <c- p>{</c->
         <c- f>"label-value"</c-><c- p>:</c-> <c- mi>1</c-><c- p>,</c->
-        <c- f>"rgba"</c-><c- p>:</c-> <c- p>[</c-><c- mi>255</c-><c- p>,</c-> <c- mi>255</c-><c- p>,</c-> <c- mi>255</c-><c- p>,</c-> <c- mi>0</c-><c- p>]</c->
+        <c- f>"rgba"</c-><c- p>:</c-> <c- p>[</c-><c- mi>255</c-><c- p>,</c-> <c- mi>255</c-><c- p>,</c-> <c- mi>255</c-><c- p>,</c-> <c- mi>255</c-><c- p>]</c->
       <c- p>},</c->
       <c- p>{</c->
         <c- f>"label-value"</c-><c- p>:</c-> <c- mi>4</c-><c- p>,</c->
         <c- f>"rgba"</c-><c- p>:</c-> <c- p>[</c-><c- mi>0</c-><c- p>,</c-> <c- mi>255</c-><c- p>,</c-> <c- mi>255</c-><c- p>,</c-> <c- mi>128</c-><c- p>]</c->
-      <c- p>},</c->
-      ...
-      <c- p>],</c->
+      <c- p>}</c->
+    <c- p>],</c->
     <c- f>"properties"</c-><c- p>:</c-> <c- p>[</c->
       <c- p>{</c->
         <c- f>"label-value"</c-><c- p>:</c-> <c- mi>1</c-><c- p>,</c->
         <c- f>"area (pixels)"</c-><c- p>:</c-> <c- mi>1200</c-><c- p>,</c->
         <c- f>"class"</c-><c- p>:</c-> <c- u>"foo"</c->
-
       <c- p>},</c->
       <c- p>{</c->
         <c- f>"label-value"</c-><c- p>:</c-> <c- mi>4</c-><c- p>,</c->
         <c- f>"area (pixels)"</c-><c- p>:</c-> <c- mi>1650</c->
-      <c- p>},</c->
-      ...
-      <c- p>]</c->
-  <c- p>},</c->
-  <c- f>"source"</c-><c- p>:</c-> <c- p>{</c->
-    <c- f>"image"</c-><c- p>:</c-> <c- u>"../../"</c->
+      <c- p>}</c->
+    <c- p>],</c->
+    <c- f>"source"</c-><c- p>:</c-> <c- p>{</c->
+      <c- f>"image"</c-><c- p>:</c-> <c- u>"../../"</c->
+    <c- p>}</c->
   <c- p>}</c->
-<c- p>]</c->
+<c- p>}</c->
 </pre>
-   <h3 class="heading settled" data-level="3.7" id="plate-md"><span class="secno">3.7. </span><span class="content">"plate" metadata</span><a class="self-link" href="#plate-md"></a></h3>
+   <h3 class="heading settled" data-level="3.8" id="plate-md"><span class="secno">3.8. </span><span class="content">"plate" metadata</span><a class="self-link" href="#plate-md"></a></h3>
    <p>For high-content screening datasets, the plate layout can be found under the
-custom attributes of the plate group under the <code>plate</code> key.</p>
-   <dl>
-    <dt><strong>acquisitions</strong>
-    <dd>An optional list of JSON objects defining the acquisitions for a given
-      plate. Each acquisition object MUST contain an <code>id</code> key providing an
-      unique identifier within the context of the plate to which fields of
-      view can refer to. It SHOULD contain  a <code>name</code> key identifying the name
-      of the acquisition. It SHOULD contain a <code>maximumfieldcount</code> key
-      indicating the maximum number of fields of view for the acquisition. It
-      MAY contain a <code>description</code> key providing a description for the
-      acquisition. It MAY contain a <code>startime</code> and/or <code>endtime</code> key specifying
-      the start and/or end timestamp of the acquisition using an epoch
-      string.
-    <dt><strong>columns</strong>
-    <dd>A list of JSON objects defining the columns of the plate. Each column
-      object defines the properties of the column at the index of the object
-      in the list. Each column in the physical plate MUST be defined, even
-      if no wells in the column are defined. Each defined column MUST contain
-      a <code>name</code> key specifying the column name. The <code>name</code> MUST contain only
-      alphanumeric characters, MUST be case-sensitive, and MUST NOT be a
-      duplicate of any other <code>name</code> in the <code>columns</code> list. Care SHOULD be
-      taken to avoid collisions on case-insensitive filesystems
-      (e.g. avoid using both <code>Aa</code> and <code>aA</code>).
-    <dt><strong>field_count</strong>
-    <dd>An integer defining the maximum number of fields per view across all
-      wells.
-    <dt><strong>name</strong>
-    <dd>A string defining the name of the plate.
-    <dt><strong>rows</strong>
-    <dd>A list of JSON objects defining the rows of the plate. Each row object
-      defines the properties of the row at the index of the object in the
-      list. Each row in the physical plate MUST be defined, even if no wells
-      in the row are defined. Each defined row MUST contain a <code>name</code> key
-      specifying the row name. The <code>name</code> MUST contain only alphanumeric
-      characters, MUST be case-sensitive, and MUST NOT be a duplicate
-      of any other <code>name</code> in the <code>rows</code> list. Care SHOULD be taken to avoid
-      collisions on case-insensitive filesystems (e.g. avoid using both <code>Aa</code> and <code>aA</code>).
-    <dt><strong>version</strong>
-    <dd>A string defining the version of the specification.
-    <dt><strong>wells</strong>
-    <dd>A list of JSON objects defining the wells of the plate. Each well object
-      MUST contain a <code>path</code> key identifying the path to the well subgroup.
-      The <code>path</code> MUST consist of a <code>name</code> in the <code>rows</code> list, a file separator (<code>/</code>),
-      and a <code>name</code> from the <code>columns</code> list, in that order. The <code>path</code> MUST NOT contain
-      additional leading or trailing directories.
-      Each well object MUST contain both a <code>rowIndex</code> key identifying the index into
-      the <code>rows</code> list and a <code>columnIndex</code> key indentifying the index into
-      the <code>columns</code> list. <code>rowIndex</code> and <code>columnIndex</code> MUST be 0-based.
-      The <code>rowIndex</code>, <code>columnIndex</code>, and <code>path</code> MUST all refer to the same
-      row/column pair.
-   </dl>
+custom attributes of the plate group under the <code>plate</code> key in the group-level metadata.</p>
+   <p>The <code>plate</code> dictionary MAY contain an <code>acquisitions</code> key whose value MUST be a list of
+JSON objects defining the acquisitions for a given plate to which wells can refer to. Each
+acquisition object MUST contain an <code>id</code> key whose value MUST be an unique integer identifier
+greater than or equal to 0 within the context of the plate to which fields of view can refer
+to (see #well-md).
+Each acquisition object SHOULD contain a <code>name</code> key whose value MUST be a string identifying
+the name of the acquisition. Each acquisition object SHOULD contain a <code>maximumfieldcount</code> key whose value MUST be a positive integer indicating the maximum number of fields of view for the
+acquisition. Each acquisition object MAY contain a <code>description</code> key whose value MUST be a
+string specifying a description for the acquisition. Each acquisition object MAY contain
+a <code>starttime</code> and/or <code>endtime</code> key whose values MUST be integer epoch timestamps specifying
+the start and/or end timestamp of the acquisition.</p>
+   <p>The <code>plate</code> dictionary MUST contain a <code>columns</code> key whose value MUST be a list of JSON objects
+defining the columns of the plate. Each column object defines the properties of
+the column at the index of the object in the list. Each column in the physical plate
+MUST be defined, even if no wells in the column are defined. Each column object MUST
+contain a <code>name</code> key whose value is a string specifying the column name. The <code>name</code> MUST
+contain only alphanumeric characters, MUST be case-sensitive, and MUST NOT be a duplicate of any
+other <code>name</code> in the <code>columns</code> list. Care SHOULD be taken to avoid collisions on
+case-insensitive filesystems (e.g. avoid using both <code>Aa</code> and <code>aA</code>).</p>
+   <p>The <code>plate</code> dictionary SHOULD contain a <code>field_count</code> key whose value MUST be a positive integer
+defining the maximum number of fields per view across all wells.</p>
+   <p>The <code>plate</code> dictionary SHOULD contain a <code>name</code> key whose value MUST be a string defining the
+name of the plate.</p>
+   <p>The <code>plate</code> dictionary MUST contain a <code>rows</code> key whose value MUST be a list of JSON objects
+defining the rows of the plate. Each row object defines the properties of
+the row at the index of the object in the list. Each row in the physical plate
+MUST be defined, even if no wells in the row are defined. Each defined row MUST
+contain a <code>name</code> key whose value MUST be a string defining the row name. The <code>name</code> MUST
+contain only alphanumeric characters, MUST be case-sensitive, and MUST NOT be a duplicate of any
+other <code>name</code> in the <code>rows</code> list. Care SHOULD be taken to avoid collisions on
+case-insensitive filesystems (e.g. avoid using both <code>Aa</code> and <code>aA</code>).</p>
+   <p>The <code>plate</code> dictionary SHOULD contain a <code>version</code> key whose value MUST be a string specifying the
+version of the plate specificaton.</p>
+   <p>The <code>plate</code> dictionary MUST contain a <code>wells</code> key whose value MUST be a list of JSON objects
+defining the wells of the plate. Each well object MUST contain a <code>path</code> key whose value MUST
+be a string specifying the path to the well subgroup. The <code>path</code> MUST consist of a <code>name</code> in
+the <code>rows</code> list, a file separator (<code>/</code>), and a <code>name</code> from the <code>columns</code> list, in that order.
+The <code>path</code> MUST NOT contain additional leading or trailing directories.
+Each well object MUST contain both a <code>rowIndex</code> key whose value MUST be an integer identifying
+the index into the <code>rows</code> list and a <code>columnIndex</code> key whose value MUST be an integer indentifying
+the index into the <code>columns</code> list. <code>rowIndex</code> and <code>columnIndex</code> MUST be 0-based. The <code>rowIndex</code>, <code>columnIndex</code>, and <code>path</code> MUST all refer to the same row/column pair.</p>
    <p>For example the following JSON object defines a plate with two acquisitions and
 6 wells (2 rows and 3 columns), containing up to 2 fields of view per acquisition.</p>
-<pre class="language-json highlight"><c- f>"plate"</c-><c- p>:</c-> <c- p>{</c->
-    <c- f>"acquisitions"</c-><c- p>:</c-> <c- p>[</c->
-        <c- p>{</c->
-            <c- f>"id"</c-><c- p>:</c-> <c- mi>1</c-><c- p>,</c->
-            <c- f>"maximumfieldcount"</c-><c- p>:</c-> <c- mi>2</c-><c- p>,</c->
-            <c- f>"name"</c-><c- p>:</c-> <c- u>"Meas_01(2012-07-31_10-41-12)"</c-><c- p>,</c->
-            <c- f>"starttime"</c-><c- p>:</c-> <c- mi>1343731272000</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"id"</c-><c- p>:</c-> <c- mi>2</c-><c- p>,</c->
-            <c- f>"maximumfieldcount"</c-><c- p>:</c-> <c- mi>2</c-><c- p>,</c->
-            <c- f>"name"</c-><c- p>:</c-> <c- u>"Meas_02(201207-31_11-56-41)"</c-><c- p>,</c->
-            <c- f>"starttime"</c-><c- p>:</c-> <c- mi>1343735801000</c->
-        <c- p>}</c->
-    <c- p>],</c->
-    <c- f>"columns"</c-><c- p>:</c-> <c- p>[</c->
-        <c- p>{</c->
-            <c- f>"name"</c-><c- p>:</c-> <c- u>"1"</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"name"</c-><c- p>:</c-> <c- u>"2"</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"name"</c-><c- p>:</c-> <c- u>"3"</c->
-        <c- p>}</c->
-    <c- p>],</c->
-    <c- f>"field_count"</c-><c- p>:</c-> <c- mi>4</c-><c- p>,</c->
-    <c- f>"name"</c-><c- p>:</c-> <c- u>"test"</c-><c- p>,</c->
-    <c- f>"rows"</c-><c- p>:</c-> <c- p>[</c->
-        <c- p>{</c->
-            <c- f>"name"</c-><c- p>:</c-> <c- u>"A"</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"name"</c-><c- p>:</c-> <c- u>"B"</c->
-        <c- p>}</c->
-    <c- p>],</c->
-    <c- f>"version"</c-><c- p>:</c-> <c- u>"0.4"</c-><c- p>,</c->
-    <c- f>"wells"</c-><c- p>:</c-> <c- p>[</c->
-        <c- p>{</c->
-            <c- f>"path"</c-><c- p>:</c-> <c- u>"A/1"</c-><c- p>,</c->
-            <c- f>"rowIndex"</c-><c- p>:</c-> <c- mi>0</c-><c- p>,</c->
-            <c- f>"columnIndex"</c-><c- p>:</c-> <c- mi>0</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"path"</c-><c- p>:</c-> <c- f>"A/2"</c->
-            <c- f>"rowIndex"</c-><c- p>:</c-> <c- mi>0</c-><c- p>,</c->
-            <c- f>"columnIndex"</c-><c- p>:</c-> <c- mi>1</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"path"</c-><c- p>:</c-> <c- f>"A/3"</c->
-            <c- f>"rowIndex"</c-><c- p>:</c-> <c- mi>0</c-><c- p>,</c->
-            <c- f>"columnIndex"</c-><c- p>:</c-> <c- mi>2</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"path"</c-><c- p>:</c-> <c- f>"B/1"</c->
-            <c- f>"rowIndex"</c-><c- p>:</c-> <c- mi>1</c-><c- p>,</c->
-            <c- f>"columnIndex"</c-><c- p>:</c-> <c- mi>0</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"path"</c-><c- p>:</c-> <c- f>"B/2"</c->
-            <c- f>"rowIndex"</c-><c- p>:</c-> <c- mi>1</c-><c- p>,</c->
-            <c- f>"columnIndex"</c-><c- p>:</c-> <c- mi>1</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"path"</c-><c- p>:</c-> <c- f>"B/3"</c->
-            <c- f>"rowIndex"</c-><c- p>:</c-> <c- mi>1</c-><c- p>,</c->
-            <c- f>"columnIndex"</c-><c- p>:</c-> <c- mi>2</c->
-        <c- p>}</c->
-    <c- p>]</c->
-  <c- p>}</c->
+<pre class="include-code highlight"><c- p>{</c->
+    <c- f>"plate"</c-><c- p>:</c-> <c- p>{</c->
+        <c- f>"acquisitions"</c-><c- p>:</c-> <c- p>[</c->
+            <c- p>{</c->
+                <c- f>"id"</c-><c- p>:</c-> <c- mi>1</c-><c- p>,</c->
+                <c- f>"maximumfieldcount"</c-><c- p>:</c-> <c- mi>2</c-><c- p>,</c->
+                <c- f>"name"</c-><c- p>:</c-> <c- u>"Meas_01(2012-07-31_10-41-12)"</c-><c- p>,</c->
+                <c- f>"starttime"</c-><c- p>:</c-> <c- mi>1343731272000</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"id"</c-><c- p>:</c-> <c- mi>2</c-><c- p>,</c->
+                <c- f>"maximumfieldcount"</c-><c- p>:</c-> <c- mi>2</c-><c- p>,</c->
+                <c- f>"name"</c-><c- p>:</c-> <c- u>"Meas_02(201207-31_11-56-41)"</c-><c- p>,</c->
+                <c- f>"starttime"</c-><c- p>:</c-> <c- mi>1343735801000</c->
+            <c- p>}</c->
+        <c- p>],</c->
+        <c- f>"columns"</c-><c- p>:</c-> <c- p>[</c->
+            <c- p>{</c->
+                <c- f>"name"</c-><c- p>:</c-> <c- u>"1"</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"name"</c-><c- p>:</c-> <c- u>"2"</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"name"</c-><c- p>:</c-> <c- u>"3"</c->
+            <c- p>}</c->
+        <c- p>],</c->
+        <c- f>"field_count"</c-><c- p>:</c-> <c- mi>4</c-><c- p>,</c->
+        <c- f>"name"</c-><c- p>:</c-> <c- u>"test"</c-><c- p>,</c->
+        <c- f>"rows"</c-><c- p>:</c-> <c- p>[</c->
+            <c- p>{</c->
+                <c- f>"name"</c-><c- p>:</c-> <c- u>"A"</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"name"</c-><c- p>:</c-> <c- u>"B"</c->
+            <c- p>}</c->
+        <c- p>],</c->
+        <c- f>"version"</c-><c- p>:</c-> <c- u>"0.4"</c-><c- p>,</c->
+        <c- f>"wells"</c-><c- p>:</c-> <c- p>[</c->
+            <c- p>{</c->
+                <c- f>"path"</c-><c- p>:</c-> <c- u>"A/1"</c-><c- p>,</c->
+                <c- f>"rowIndex"</c-><c- p>:</c-> <c- mi>0</c-><c- p>,</c->
+                <c- f>"columnIndex"</c-><c- p>:</c-> <c- mi>0</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"path"</c-><c- p>:</c-> <c- u>"A/2"</c-><c- p>,</c->
+                <c- f>"rowIndex"</c-><c- p>:</c-> <c- mi>0</c-><c- p>,</c->
+                <c- f>"columnIndex"</c-><c- p>:</c-> <c- mi>1</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"path"</c-><c- p>:</c-> <c- u>"A/3"</c-><c- p>,</c->
+                <c- f>"rowIndex"</c-><c- p>:</c-> <c- mi>0</c-><c- p>,</c->
+                <c- f>"columnIndex"</c-><c- p>:</c-> <c- mi>2</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"path"</c-><c- p>:</c-> <c- u>"B/1"</c-><c- p>,</c->
+                <c- f>"rowIndex"</c-><c- p>:</c-> <c- mi>1</c-><c- p>,</c->
+                <c- f>"columnIndex"</c-><c- p>:</c-> <c- mi>0</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"path"</c-><c- p>:</c-> <c- u>"B/2"</c-><c- p>,</c->
+                <c- f>"rowIndex"</c-><c- p>:</c-> <c- mi>1</c-><c- p>,</c->
+                <c- f>"columnIndex"</c-><c- p>:</c-> <c- mi>1</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"path"</c-><c- p>:</c-> <c- u>"B/3"</c-><c- p>,</c->
+                <c- f>"rowIndex"</c-><c- p>:</c-> <c- mi>1</c-><c- p>,</c->
+                <c- f>"columnIndex"</c-><c- p>:</c-> <c- mi>2</c->
+            <c- p>}</c->
+        <c- p>]</c->
+    <c- p>}</c->
+<c- p>}</c->
 </pre>
    <p>The following JSON object defines a sparse plate with one acquisition and
 2 wells in a 96 well plate, containing one field of view per acquisition.</p>
-<pre class="language-json highlight"><c- f>"plate"</c-><c- p>:</c-> <c- p>{</c->
-    <c- f>"acquisitions"</c-><c- p>:</c-> <c- p>[</c->
-        <c- p>{</c->
-            <c- f>"id"</c-><c- p>:</c-> <c- mi>1</c-><c- p>,</c->
-            <c- f>"maximumfieldcount"</c-><c- p>:</c-> <c- mi>1</c-><c- p>,</c->
-            <c- f>"name"</c-><c- p>:</c-> <c- u>"single acquisition"</c-><c- p>,</c->
-            <c- f>"starttime"</c-><c- p>:</c-> <c- mi>1343731272000</c->
-        <c- p>},</c->
-    <c- p>],</c->
-    <c- f>"columns"</c-><c- p>:</c-> <c- p>[</c->
-        <c- p>{</c->
-            <c- f>"name"</c-><c- p>:</c-> <c- u>"1"</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"name"</c-><c- p>:</c-> <c- u>"2"</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"name"</c-><c- p>:</c-> <c- u>"3"</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"name"</c-><c- p>:</c-> <c- u>"4"</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"name"</c-><c- p>:</c-> <c- u>"5"</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"name"</c-><c- p>:</c-> <c- u>"6"</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"name"</c-><c- p>:</c-> <c- u>"7"</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"name"</c-><c- p>:</c-> <c- u>"8"</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"name"</c-><c- p>:</c-> <c- u>"9"</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"name"</c-><c- p>:</c-> <c- u>"10"</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"name"</c-><c- p>:</c-> <c- u>"11"</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"name"</c-><c- p>:</c-> <c- u>"12"</c->
-        <c- p>}</c->
-    <c- p>],</c->
-    <c- f>"field_count"</c-><c- p>:</c-> <c- mi>1</c-><c- p>,</c->
-    <c- f>"name"</c-><c- p>:</c-> <c- u>"sparse test"</c-><c- p>,</c->
-    <c- f>"rows"</c-><c- p>:</c-> <c- p>[</c->
-        <c- p>{</c->
-            <c- f>"name"</c-><c- p>:</c-> <c- u>"A"</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"name"</c-><c- p>:</c-> <c- u>"B"</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"name"</c-><c- p>:</c-> <c- u>"C"</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"name"</c-><c- p>:</c-> <c- u>"D"</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"name"</c-><c- p>:</c-> <c- u>"E"</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"name"</c-><c- p>:</c-> <c- u>"F"</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"name"</c-><c- p>:</c-> <c- u>"G"</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"name"</c-><c- p>:</c-> <c- u>"H"</c->
-        <c- p>}</c->
-    <c- p>],</c->
-    <c- f>"version"</c-><c- p>:</c-> <c- u>"0.1"</c-><c- p>,</c->
-    <c- f>"wells"</c-><c- p>:</c-> <c- p>[</c->
-        <c- p>{</c->
-            <c- f>"path"</c-><c- p>:</c-> <c- f>"C/5"</c->
-            <c- f>"rowIndex"</c-><c- p>:</c-> <c- mi>2</c-><c- p>,</c->
-            <c- f>"columnIndex"</c-><c- p>:</c-> <c- mi>4</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"path"</c-><c- p>:</c-> <c- f>"D/7"</c->
-            <c- f>"rowIndex"</c-><c- p>:</c-> <c- mi>3</c-><c- p>,</c->
-            <c- f>"columnIndex"</c-><c- p>:</c-> <c- mi>6</c->
-        <c- p>}</c->
-    <c- p>]</c->
-  <c- p>}</c->
+<pre class="include-code highlight"><c- p>{</c->
+    <c- f>"plate"</c-><c- p>:</c-> <c- p>{</c->
+        <c- f>"acquisitions"</c-><c- p>:</c-> <c- p>[</c->
+            <c- p>{</c->
+                <c- f>"id"</c-><c- p>:</c-> <c- mi>1</c-><c- p>,</c->
+                <c- f>"maximumfieldcount"</c-><c- p>:</c-> <c- mi>1</c-><c- p>,</c->
+                <c- f>"name"</c-><c- p>:</c-> <c- u>"single acquisition"</c-><c- p>,</c->
+                <c- f>"starttime"</c-><c- p>:</c-> <c- mi>1343731272000</c->
+            <c- p>}</c->
+        <c- p>],</c->
+        <c- f>"columns"</c-><c- p>:</c-> <c- p>[</c->
+            <c- p>{</c->
+                <c- f>"name"</c-><c- p>:</c-> <c- u>"1"</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"name"</c-><c- p>:</c-> <c- u>"2"</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"name"</c-><c- p>:</c-> <c- u>"3"</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"name"</c-><c- p>:</c-> <c- u>"4"</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"name"</c-><c- p>:</c-> <c- u>"5"</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"name"</c-><c- p>:</c-> <c- u>"6"</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"name"</c-><c- p>:</c-> <c- u>"7"</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"name"</c-><c- p>:</c-> <c- u>"8"</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"name"</c-><c- p>:</c-> <c- u>"9"</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"name"</c-><c- p>:</c-> <c- u>"10"</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"name"</c-><c- p>:</c-> <c- u>"11"</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"name"</c-><c- p>:</c-> <c- u>"12"</c->
+            <c- p>}</c->
+        <c- p>],</c->
+        <c- f>"field_count"</c-><c- p>:</c-> <c- mi>1</c-><c- p>,</c->
+        <c- f>"name"</c-><c- p>:</c-> <c- u>"sparse test"</c-><c- p>,</c->
+        <c- f>"rows"</c-><c- p>:</c-> <c- p>[</c->
+            <c- p>{</c->
+                <c- f>"name"</c-><c- p>:</c-> <c- u>"A"</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"name"</c-><c- p>:</c-> <c- u>"B"</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"name"</c-><c- p>:</c-> <c- u>"C"</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"name"</c-><c- p>:</c-> <c- u>"D"</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"name"</c-><c- p>:</c-> <c- u>"E"</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"name"</c-><c- p>:</c-> <c- u>"F"</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"name"</c-><c- p>:</c-> <c- u>"G"</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"name"</c-><c- p>:</c-> <c- u>"H"</c->
+            <c- p>}</c->
+        <c- p>],</c->
+        <c- f>"version"</c-><c- p>:</c-> <c- u>"0.4"</c-><c- p>,</c->
+        <c- f>"wells"</c-><c- p>:</c-> <c- p>[</c->
+            <c- p>{</c->
+                <c- f>"path"</c-><c- p>:</c-> <c- u>"C/5"</c-><c- p>,</c->
+                <c- f>"rowIndex"</c-><c- p>:</c-> <c- mi>2</c-><c- p>,</c->
+                <c- f>"columnIndex"</c-><c- p>:</c-> <c- mi>4</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"path"</c-><c- p>:</c-> <c- u>"D/7"</c-><c- p>,</c->
+                <c- f>"rowIndex"</c-><c- p>:</c-> <c- mi>3</c-><c- p>,</c->
+                <c- f>"columnIndex"</c-><c- p>:</c-> <c- mi>6</c->
+            <c- p>}</c->
+        <c- p>]</c->
+    <c- p>}</c->
+<c- p>}</c->
 </pre>
-   <h3 class="heading settled" data-level="3.8" id="well-md"><span class="secno">3.8. </span><span class="content">"well" metadata</span><a class="self-link" href="#well-md"></a></h3>
+   <h3 class="heading settled" data-level="3.9" id="well-md"><span class="secno">3.9. </span><span class="content">"well" metadata</span><a class="self-link" href="#well-md"></a></h3>
    <p>For high-content screening datasets, the metadata about all fields of views
 under a given well can be found under the "well" key in the attributes of the
 well group.</p>
-   <dl>
-    <dt><strong>images</strong>
-    <dd>A list of JSON objects defining the fields of views for a given well.
-      Each object MUST contain a <code>path</code> key identifying the path to the
-      field of view. If multiple acquisitions were performed in the plate, it
-      MUST contain an <code>acquisition</code> key identifying the id of the
-      acquisition which must match one of acquisition JSON objects defined in
-      the plate metadata.
-    <dt><strong>version</strong>
-    <dd>A string defining the version of the specification.
-   </dl>
+   <p>The <code>well</code> dictionary MUST contain an <code>images</code> key whose value MUST be a list of JSON objects
+specifying all fields of views for a given well. Each image object MUST contain a <code>path</code> key whose value MUST be a string specifying the path to the field of view. The <code>path</code> MUST contain only alphanumeric characters, MUST be case-sensitive, and MUST NOT be a duplicate
+of any other <code>path</code> in the <code>images</code> list. If multiple acquisitions were performed in the plate,
+it MUST contain an <code>acquisition</code> key whose value MUST be an integer identifying the acquisition
+which MUST match one of the acquisition JSON objects defined in the plate metadata (see #plate-md).</p>
+   <p>The <code>well</code> dictionary SHOULD contain a <code>version</code> key whose value MUST be a string specifying the
+version of the well specification.</p>
    <p>For example the following JSON object defines a well with four fields of
 view. The first two fields of view were part of the first acquisition while
 the last two fields of view were part of the second acquisition.</p>
-<pre class="language-json highlight"><c- f>"well"</c-><c- p>:</c-> <c- p>{</c->
-    <c- f>"images"</c-><c- p>:</c-> <c- p>[</c->
-        <c- p>{</c->
-            <c- f>"acquisition"</c-><c- p>:</c-> <c- mi>1</c-><c- p>,</c->
-            <c- f>"path"</c-><c- p>:</c-> <c- u>"0"</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"acquisition"</c-><c- p>:</c-> <c- mi>1</c-><c- p>,</c->
-            <c- f>"path"</c-><c- p>:</c-> <c- u>"1"</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"acquisition"</c-><c- p>:</c-> <c- mi>2</c-><c- p>,</c->
-            <c- f>"path"</c-><c- p>:</c-> <c- u>"2"</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"acquisition"</c-><c- p>:</c-> <c- mi>2</c-><c- p>,</c->
-            <c- f>"path"</c-><c- p>:</c-> <c- u>"3"</c->
-        <c- p>}</c->
-    <c- p>],</c->
-    <c- f>"version"</c-><c- p>:</c-> <c- u>"0.4"</c->
-  <c- p>}</c->
-</pre>
+<pre class="include-code highlight"><c- p>{</c->
+    <c- f>"well"</c-><c- p>:</c-> <c- p>{</c->
+        <c- f>"images"</c-><c- p>:</c-> <c- p>[</c->
+            <c- p>{</c->
+                <c- f>"acquisition"</c-><c- p>:</c-> <c- mi>1</c-><c- p>,</c->
+                <c- f>"path"</c-><c- p>:</c-> <c- u>"0"</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"acquisition"</c-><c- p>:</c-> <c- mi>1</c-><c- p>,</c->
+                <c- f>"path"</c-><c- p>:</c-> <c- u>"1"</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"acquisition"</c-><c- p>:</c-> <c- mi>2</c-><c- p>,</c->
+                <c- f>"path"</c-><c- p>:</c-> <c- u>"2"</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"acquisition"</c-><c- p>:</c-> <c- mi>2</c-><c- p>,</c->
+                <c- f>"path"</c-><c- p>:</c-> <c- u>"3"</c->
+            <c- p>}</c->
+        <c- p>],</c->
+        <c- f>"version"</c-><c- p>:</c-> <c- u>"0.4"</c->
+    <c- p>}</c->
+<c- p>}</c-></pre>
    <p>The following JSON object defines a well with two fields of view in a plate with
 four acquisitions. The first field is part of the first acquisition, and the second
 field is part of the last acquisition.</p>
-<pre class="language-json highlight"><c- f>"well"</c-><c- p>:</c-> <c- p>{</c->
-    <c- f>"images"</c-><c- p>:</c-> <c- p>[</c->
-        <c- p>{</c->
-            <c- f>"acquisition"</c-><c- p>:</c-> <c- mi>0</c-><c- p>,</c->
-            <c- f>"path"</c-><c- p>:</c-> <c- u>"0"</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"acquisition"</c-><c- p>:</c-> <c- mi>3</c-><c- p>,</c->
-            <c- f>"path"</c-><c- p>:</c-> <c- u>"1"</c->
-        <c- p>}</c->
-    <c- p>],</c->
-    <c- f>"version"</c-><c- p>:</c-> <c- u>"0.1"</c->
-<c- p>}</c->
-</pre>
+<pre class="include-code highlight"><c- p>{</c->
+    <c- f>"well"</c-><c- p>:</c-> <c- p>{</c->
+        <c- f>"images"</c-><c- p>:</c-> <c- p>[</c->
+            <c- p>{</c->
+                <c- f>"acquisition"</c-><c- p>:</c-> <c- mi>0</c-><c- p>,</c->
+                <c- f>"path"</c-><c- p>:</c-> <c- u>"0"</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"acquisition"</c-><c- p>:</c-> <c- mi>3</c-><c- p>,</c->
+                <c- f>"path"</c-><c- p>:</c-> <c- u>"1"</c->
+            <c- p>}</c->
+        <c- p>],</c->
+        <c- f>"version"</c-><c- p>:</c-> <c- u>"0.4"</c->
+    <c- p>}</c->
+<c- p>}</c-></pre>
    <h2 class="heading settled" data-level="4" id="naming-style"><span class="secno">4. </span><span class="content">Specification naming style</span><a class="self-link" href="#naming-style"></a></h2>
    <p>Multi-word keys in this specification should use the <code>camelCase</code> style.
 NB: some parts of the specification don’t obey this convention as they
@@ -1134,6 +1289,10 @@ <h2 class="heading settled" data-level="7" id="history"><span class="secno">7. <
       <td>Date
       <td>Description
     <tbody>
+     <tr>
+      <td>0.4.1
+      <td>2022-09-26
+      <td>transitional metadata for image collections ("bioformats2raw.layout")
      <tr>
       <td>0.4.0
       <td>2022-02-08
@@ -1197,7 +1356,7 @@ <h3 class="no-ref no-num heading settled" id="w3c-conventions"><span class="cont
     and are set apart from the normative text
     with <code>class="note"</code>,
     like this: </p>
-   <p class="note" role="note">Note, this is an informative note. </p>
+   <p class="note" role="note">Note, this is an informative note.</p>
    <h3 class="no-ref no-num heading settled" id="w3c-conformant-algorithms"><span class="content">Conformant Algorithms</span><a class="self-link" href="#w3c-conformant-algorithms"></a></h3>
    <p>Requirements phrased in the imperative as part of algorithms
     (such as "strip any leading space characters"
@@ -1217,8 +1376,10 @@ <h3 class="no-ref no-num heading settled" id="w3c-conformant-algorithms"><span c
   <h2 class="no-num no-ref heading settled" id="index"><span class="content">Index</span><a class="self-link" href="#index"></a></h2>
   <h3 class="no-num no-ref heading settled" id="index-defined-here"><span class="content">Terms defined by this specification</span><a class="self-link" href="#index-defined-here"></a></h3>
   <ul class="index">
+   <li><a href="#hcs">HCS</a><span>, in § 3.2.3</span>
    <li><a href="#hdf5">HDF5</a><span>, in § 1.1</span>
    <li><a href="#ngff">NGFF</a><span>, in § 1.1</span>
+   <li><a href="#transitional">Transitional</a><span>, in § 1.3</span>
   </ul>
   <h2 class="no-num no-ref heading settled" id="references"><span class="content">References</span><a class="self-link" href="#references"></a></h2>
   <h3 class="no-num no-ref heading settled" id="normative"><span class="content">Normative References</span><a class="self-link" href="#normative"></a></h3>
@@ -1234,4 +1395,67 @@ <h3 class="no-num no-ref heading settled" id="informative"><span class="content"
    <dd>OME; et al. <a href="https://doi.org/10.5281/zenodo.4113931"><cite>ome-zarr-py: Experimental implementation of next-generation file format (NGFF) specifications for storing bioimaging data in the cloud.</cite></a>. 06 October 2020. Informational. URL: <a href="https://doi.org/10.5281/zenodo.4113931">https://doi.org/10.5281/zenodo.4113931</a>
    <dt id="biblio-zarr">[ZARR]
    <dd>Alistair Miles; et al. <a href="https://doi.org/10.5281/zenodo.4069231"><cite>Zarr: An implementation of chunked, compressed, N-dimensional arrays for Python.</cite></a>. 06 October 2020. Informational. URL: <a href="https://doi.org/10.5281/zenodo.4069231">https://doi.org/10.5281/zenodo.4069231</a>
-  </dl>
\ No newline at end of file
+  </dl>
+  <aside class="dfn-panel" data-for="transitional">
+   <b><a href="#transitional">#transitional</a></b><b>Referenced in:</b>
+   <ul>
+    <li><a href="#ref-for-transitional">3.2. "bioformats2raw.layout" (transitional)</a>
+    <li><a href="#ref-for-transitional①">3.5. "omero" metadata (transitional)</a>
+   </ul>
+  </aside>
+<script>/* script-dfn-panel */
+
+document.body.addEventListener("click", function(e) {
+    var queryAll = function(sel) { return [].slice.call(document.querySelectorAll(sel)); }
+    // Find the dfn element or panel, if any, that was clicked on.
+    var el = e.target;
+    var target;
+    var hitALink = false;
+    while(el.parentElement) {
+        if(el.tagName == "A") {
+            // Clicking on a link in a <dfn> shouldn't summon the panel
+            hitALink = true;
+        }
+        if(el.classList.contains("dfn-paneled")) {
+            target = "dfn";
+            break;
+        }
+        if(el.classList.contains("dfn-panel")) {
+            target = "dfn-panel";
+            break;
+        }
+        el = el.parentElement;
+    }
+    if(target != "dfn-panel") {
+        // Turn off any currently "on" or "activated" panels.
+        queryAll(".dfn-panel.on, .dfn-panel.activated").forEach(function(el){
+            el.classList.remove("on");
+            el.classList.remove("activated");
+        });
+    }
+    if(target == "dfn" && !hitALink) {
+        // open the panel
+        var dfnPanel = document.querySelector(".dfn-panel[data-for='" + el.id + "']");
+        if(dfnPanel) {
+            dfnPanel.classList.add("on");
+            var rect = el.getBoundingClientRect();
+            dfnPanel.style.left = window.scrollX + rect.right + 5 + "px";
+            dfnPanel.style.top = window.scrollY + rect.top + "px";
+            var panelRect = dfnPanel.getBoundingClientRect();
+            var panelWidth = panelRect.right - panelRect.left;
+            if(panelRect.right > document.body.scrollWidth && (rect.left - (panelWidth + 5)) > 0) {
+                // Reposition, because the panel is overflowing
+                dfnPanel.style.left = window.scrollX + rect.left - (panelWidth + 5) + "px";
+            }
+        } else {
+            console.log("Couldn't find .dfn-panel[data-for='" + el.id + "']");
+        }
+    } else if(target == "dfn-panel") {
+        // Switch it to "activated" state, which pins it.
+        el.classList.add("activated");
+        el.style.left = null;
+        el.style.top = null;
+    }
+
+});
+</script>
\ No newline at end of file
diff --git a/0.4/schemas/image.schema b/0.4/schemas/image.schema
new file mode 100644
index 00000000..59e8e28e
--- /dev/null
+++ b/0.4/schemas/image.schema
@@ -0,0 +1,233 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://ngff.openmicroscopy.org/0.4/schemas/image.schema",
+  "title": "NGFF Image",
+  "description": "JSON from OME-NGFF .zattrs",
+  "type": "object",
+  "properties": {
+    "multiscales": {
+      "description": "The multiscale datasets for this image",
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string"
+          },
+          "datasets": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+              "type": "object",
+              "properties": {
+                "path": {
+                  "type": "string"
+                },
+                "coordinateTransformations": {
+                  "$ref": "#/$defs/coordinateTransformations"
+                }
+              },
+              "required": ["path", "coordinateTransformations"]
+            }
+          },
+          "version": {
+            "type": "string",
+            "enum": [
+              "0.4"
+            ]
+          },
+          "axes": {
+            "$ref": "#/$defs/axes"
+          },
+          "coordinateTransformations": {
+            "$ref": "#/$defs/coordinateTransformations"
+                }
+        },
+        "required": [
+          "datasets", "axes"
+        ]
+      },
+      "minItems": 1,
+      "uniqueItems": true
+    },
+    "omero": {
+      "type": "object",
+      "properties": {
+        "channels": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "window": {
+                "type": "object",
+                "properties": {
+                  "end": {
+                    "type": "number"
+                  },
+                  "max": {
+                    "type": "number"
+                  },
+                  "min": {
+                    "type": "number"
+                  },
+                  "start": {
+                    "type": "number"
+                  }
+                },
+                "required": [
+                  "start",
+                  "min",
+                  "end",
+                  "max"
+                ]
+              },
+              "label": {
+                "type": "string"
+              },
+              "family": {
+                "type": "string"
+              },
+              "color": {
+                "type": "string"
+              },
+              "active": {
+                "type": "boolean"
+              }
+            },
+            "required": [
+              "window",
+              "color"
+            ]
+          }
+        }
+      },
+      "required": [
+        "channels"
+      ]
+    }
+  },
+  "required": [ "multiscales" ],
+
+  "$defs": {
+    "axes": {
+      "type": "array",
+      "uniqueItems": true,
+      "minItems": 2,
+      "maxItems": 5,
+      "contains": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string"
+          },
+          "type": {
+            "type": "string",
+            "enum": ["space"]
+          },
+          "units": {
+            "type": "string"
+          }
+        }
+      },
+      "minContains": 2,
+      "maxContains": 3,
+      "items": {
+        "oneOf": [
+          {
+            "type": "object",
+            "properties": {
+              "name": {
+                "type": "string"
+              },
+              "type": {
+                "type": "string",
+                "enum": ["channel", "time", "space"]
+              }
+            },
+            "required": ["name", "type"]
+          },
+          {
+            "type": "object",
+            "properties": {
+              "name": {
+                "type": "string"
+              },
+              "type": {
+                "type": "string",
+                "not": {
+                  "enum": ["space", "time", "channel"]
+                }
+              }
+            },
+            "required": ["name"]
+          }
+        ]
+      }
+    },
+    "coordinateTransformations": {
+      "type": "array",
+      "minItems": 1,
+      "contains": {
+        "type": "object",
+        "properties": {
+          "type": {
+            "type": "string",
+            "enum": [
+              "scale"
+            ]
+          },
+          "scale": {
+            "type": "array",
+            "minItems": 2,
+            "items": {
+              "type": "number"
+            }
+          }
+        }
+      },
+      "maxContains": 1,
+      "items": {
+        "oneOf": [
+          {
+            "type": "object",
+            "properties": {
+              "type": {
+                "type": "string",
+                "enum": [
+                  "scale"
+                ]
+              },
+              "scale": {
+                "type": "array",
+                "minItems": 2,
+                "items": {
+                  "type": "number"
+                }
+              }
+            },
+            "required": ["type", "scale"]
+          },
+          {
+            "type": "object",
+            "properties": {
+              "type": {
+                "type": "string",
+                "enum": [
+                  "translation"
+                ]
+              },
+              "translation": {
+                "type": "array",
+                "minItems": 2,
+                "items": {
+                  "type": "number"
+                }
+              }
+            },
+            "required": ["type", "translation"]
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/0.4/schemas/label.schema b/0.4/schemas/label.schema
new file mode 100644
index 00000000..1629d0f9
--- /dev/null
+++ b/0.4/schemas/label.schema
@@ -0,0 +1,77 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://ngff.openmicroscopy.org/0.4/schemas/label.schema",
+  "title": "OME-NGFF labelled image schema",
+  "description": "JSON from OME-NGFF .zattrs",
+  "type": "object",
+  "properties": {
+    "image-label": {
+      "type": "object",
+      "properties": {
+        "colors": {
+          "description": "The colors for this label image",
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "label-value": {
+                "description": "The value of the label",
+                "type": "number"
+              },
+              "rgba": {
+                "description": "The RGBA color stored as an array of four integers between 0 and 255",
+                "type": "array",
+                "items": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 255
+                },
+                "minItems": 4,
+                "maxItems": 4
+              }
+            },
+            "required": [
+              "label-value"
+            ]
+          },
+          "minItems": 1,
+          "uniqueItems": true
+        },
+        "properties": {
+          "description": "The properties for this label image",
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "label-value": {
+                "description": "The pixel value for this label",
+                "type": "integer"
+              }
+            },
+            "required": [
+              "label-value"
+            ]
+          },
+          "minItems": 1,
+          "uniqueItems": true
+        },
+        "source": {
+          "description": "The source of this label image",
+          "type": "object",
+          "properties": {
+            "image": {
+              "type": "string"
+            }
+          }
+        },
+        "version": {
+          "description": "The version of the specification",
+          "type": "string",
+          "enum": [
+            "0.4"
+          ]
+        }
+      }
+    }
+  }
+}
diff --git a/0.4/schemas/plate.schema b/0.4/schemas/plate.schema
new file mode 100644
index 00000000..df7cfad0
--- /dev/null
+++ b/0.4/schemas/plate.schema
@@ -0,0 +1,140 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://ngff.openmicroscopy.org/0.4/schemas/plate.schema",
+  "title": "OME-NGFF plate schema",
+  "description": "JSON from OME-NGFF .zattrs",
+  "type": "object",
+  "properties": {
+    "plate": {
+      "type": "object",
+      "properties": {
+        "acquisitions": {
+          "description": "The acquisitions for this plate",
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "description": "A unique identifier within the context of the plate",
+                "type": "integer",
+                "minimum": 0
+              },
+              "maximumfieldcount": {
+                "description": "The maximum number of fields of view for the acquisition",
+                "type": "integer",
+                "exclusiveMinimum": 0
+              },
+              "name": {
+                "description": "The name of the acquisition",
+                "type": "string"
+              },
+              "description": {
+                "description": "The description of the acquisition",
+                "type": "string"
+              },
+              "starttime": {
+                "description": "The start timestamp of the acquisition, expressed as epoch time i.e. the number seconds since the Epoch",
+                "type": "integer",
+                "minimum": 0
+              },
+              "endtime": {
+                "description": "The end timestamp of the acquisition, expressed as epoch time i.e. the number seconds since the Epoch",
+                "type": "integer",
+                "minimum": 0
+              }
+            },
+            "required": [
+              "id"
+            ]
+          }
+        },
+        "version": {
+          "description": "The version of the specification",
+          "type": "string",
+          "enum": [
+            "0.4"
+          ]
+        },
+        "field_count": {
+          "description": "The maximum number of fields per view across all wells",
+          "type": "integer",
+          "exclusiveMinimum": 0
+        },
+        "name": {
+          "description": "The name of the plate",
+          "type": "string"
+        },
+        "columns": {
+          "description": "The columns of the plate",
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "name": {
+                "description": "The column name",
+                "type": "string",
+                "pattern": "^[A-Za-z0-9]+$"
+              }
+            },
+            "required": [
+              "name"
+            ]
+          },
+          "minItems": 1,
+          "uniqueItems": true
+        },
+        "rows": {
+          "description": "The rows of the plate",
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "name": {
+                "description": "The row name",
+                "type": "string",
+                "pattern": "^[A-Za-z0-9]+$"
+              }
+            },
+            "required": [
+              "name"
+            ]
+          },
+          "minItems": 1,
+          "uniqueItems": true
+        },
+        "wells": {
+          "description": "The wells of the plate",
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "path": {
+                "description": "The path to the well subgroup",
+                "type": "string",
+                "pattern": "^[A-Za-z0-9]+/[A-Za-z0-9]+$"
+              },
+              "rowIndex": {
+                "description": "The index of the well in the rows list",
+                "type": "integer",
+                "minimum": 0
+              },
+              "columnIndex": {
+                "description": "The index of the well in the columns list",
+                "type": "integer",
+                "minimum": 0
+              }
+            },
+            "required": [
+              "path", "rowIndex", "columnIndex"
+            ]
+          },
+          "minItems": 1,
+          "uniqueItems": true
+        }
+      },
+      "required": [
+        "columns", "rows", "wells"
+      ]
+    }
+  }
+}
diff --git a/0.4/schemas/strict_image.schema b/0.4/schemas/strict_image.schema
new file mode 100644
index 00000000..87d0d6b5
--- /dev/null
+++ b/0.4/schemas/strict_image.schema
@@ -0,0 +1,19 @@
+{
+  "$id": "https://ngff.openmicroscopy.org/0.4/schemas/strict_image.schema",
+  "allOf": [
+    {
+      "$ref": "https://ngff.openmicroscopy.org/0.4/schemas/image.schema"
+    },
+    {
+      "properties": {
+        "multiscales": {
+          "items": {
+            "required": [
+              "version", "metadata", "type", "name"
+            ]
+          }
+        }
+      }
+    }
+  ]
+}
\ No newline at end of file
diff --git a/0.4/schemas/strict_label.schema b/0.4/schemas/strict_label.schema
new file mode 100644
index 00000000..af9090da
--- /dev/null
+++ b/0.4/schemas/strict_label.schema
@@ -0,0 +1,18 @@
+{
+  "$id": "https://ngff.openmicroscopy.org/0.4/schemas/strict_label.schema",
+  "allOf": [
+    {
+      "$ref": "https://ngff.openmicroscopy.org/0.4/schemas/label.schema"
+    },
+    {
+      "properties": {
+        "image-label": {
+          "required": [
+            "version",
+            "colors"
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/0.4/schemas/strict_plate.schema b/0.4/schemas/strict_plate.schema
new file mode 100644
index 00000000..5a88ab72
--- /dev/null
+++ b/0.4/schemas/strict_plate.schema
@@ -0,0 +1,28 @@
+{
+  "$id": "https://ngff.openmicroscopy.org/0.4/schemas/strict_plate.schema",
+  "allOf": [
+    {
+      "$ref": "https://ngff.openmicroscopy.org/0.4/schemas/plate.schema"
+    },
+    {
+      "properties": {
+        "plate": {
+          "properties": {
+            "acquisitions": {
+              "items": {
+                "required": [
+                  "name",
+                  "maximumfieldcount"
+                ]
+              }
+            }
+          },
+          "required": [
+            "name",
+            "version"
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/0.4/schemas/strict_well.schema b/0.4/schemas/strict_well.schema
new file mode 100644
index 00000000..1e200294
--- /dev/null
+++ b/0.4/schemas/strict_well.schema
@@ -0,0 +1,17 @@
+{
+  "$id": "https://ngff.openmicroscopy.org/0.4/schemas/strict_well.schema",
+  "allOf": [
+    {
+      "$ref": "https://ngff.openmicroscopy.org/0.4/schemas/well.schema"
+    },
+    {
+      "properties": {
+        "well": {
+          "required": [
+            "version"
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/0.4/schemas/well.schema b/0.4/schemas/well.schema
new file mode 100644
index 00000000..971a0102
--- /dev/null
+++ b/0.4/schemas/well.schema
@@ -0,0 +1,47 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://ngff.openmicroscopy.org/0.4/schemas/well.schema",
+  "title": "OME-NGFF well schema",
+  "description": "JSON from OME-NGFF .zattrs",
+  "type": "object",
+  "properties": {
+    "well": {
+      "type": "object",
+      "properties": {
+        "images": {
+          "description": "The fields of view for this well",
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "acquisition": {
+                "description": "A unique identifier within the context of the plate",
+                "type": "integer"
+              },
+              "path": {
+                "description": "The path for this field of view subgroup",
+                "type": "string",
+                "pattern": "^[A-Za-z0-9]+$"
+              }
+            },
+            "required": [
+              "path"
+            ]
+          },
+          "minItems": 1,
+          "uniqueItems": true
+        },
+        "version": {
+          "description": "The version of the specification",
+          "type": "string",
+          "enum": [
+            "0.4"
+          ]
+        }
+      },
+      "required": [
+        "images"
+      ]
+    }
+  }
+}
diff --git a/latest/index.html b/latest/index.html
index 15cb3594..934f0360 100644
--- a/latest/index.html
+++ b/latest/index.html
@@ -1487,9 +1487,9 @@
 		}
 	}
 </style>
-  <meta content="Bikeshed version fb1e763a4, updated Tue Mar 1 13:13:50 2022 -0800" name="generator">
+  <meta content="Bikeshed version b0de3432c, updated Thu Oct 13 09:16:59 2022 -0700" name="generator">
   <link href="https://ngff.openmicroscopy.org/latest/" rel="canonical">
-  <meta content="8dec6918ee6630f43f339b281b66043e0a797ca4" name="document-revision">
+  <meta content="449fbca8a9d3fa7489e2e24039dc15a26ab3338d" name="document-revision">
 <style>/* style-autolinks */
 
 .css.css, .property.property, .descriptor.descriptor {
@@ -1690,6 +1690,47 @@
 figcaption:not(.no-marker)::before {
     content: "Figure " counter(figure) " ";
 }</style>
+<style>/* style-dfn-panel */
+
+:root {
+    --dfnpanel-bg: #ddd;
+    --dfnpanel-text: var(--text);
+}
+.dfn-panel {
+    position: absolute;
+    z-index: 35;
+    height: auto;
+    width: -webkit-fit-content;
+    width: fit-content;
+    max-width: 300px;
+    max-height: 500px;
+    overflow: auto;
+    padding: 0.5em 0.75em;
+    font: small Helvetica Neue, sans-serif, Droid Sans Fallback;
+    background: var(--dfnpanel-bg);
+    color: var(--dfnpanel-text);
+    border: outset 0.2em;
+}
+.dfn-panel:not(.on) { display: none; }
+.dfn-panel * { margin: 0; padding: 0; text-indent: 0; }
+.dfn-panel > b { display: block; }
+.dfn-panel a { color: var(--dfnpanel-text); }
+.dfn-panel a:not(:hover) { text-decoration: none !important; border-bottom: none !important; }
+.dfn-panel > b + b { margin-top: 0.25em; }
+.dfn-panel ul { padding: 0; }
+.dfn-panel li { list-style: inside; }
+.dfn-panel.activated {
+    display: inline-block;
+    position: fixed;
+    left: .5em;
+    bottom: 2em;
+    margin: 0 auto;
+    max-width: calc(100vw - 1.5em - .4em - .5em);
+    max-height: 30vh;
+}
+
+.dfn-paneled { cursor: pointer; }
+</style>
 <style>/* style-issues */
 
 a[href].issue-return {
@@ -1825,7 +1866,7 @@
   <div class="head">
     <img alt="OME logo (6 circles in a hexagon)" src="http://www.openmicroscopy.org/img/logos/ome-logomark.svg" style="float:right;width:42px;height:42px;"> 
    <h1 class="p-name no-ref" id="title">Next-generation file formats (NGFF)</h1>
-   <h2 class="no-num no-toc no-ref heading settled" id="subtitle"><span class="content">Editor’s Draft, <time class="dt-updated" datetime="2022-03-18">18 March 2022</time></span></h2>
+   <h2 class="no-num no-toc no-ref heading settled" id="subtitle"><span class="content">Editor’s Draft, <time class="dt-updated" datetime="2022-10-20">20 October 2022</time></span></h2>
    <div data-fill-with="spec-metadata">
     <dl>
      <dt>This version:
@@ -1867,6 +1908,7 @@ <h2 class="no-num no-toc no-ref" id="contents">Table of Contents</h2>
      <ol class="toc">
       <li><a href="#why-ngff"><span class="secno">1.1</span> <span class="content">Why "<span><abbr title="Next-generation file-format">NGFF</abbr></span>"?</span></a>
       <li><a href="#ome-ngff"><span class="secno">1.2</span> <span class="content">OME-NGFF</span></a>
+      <li><a href="#document-conventions"><span class="secno">1.3</span> <span class="content">Document conventions</span></a>
      </ol>
     <li>
      <a href="#on-disk"><span class="secno">2</span> <span class="content">On-disk (or in-cloud) layout</span></a>
@@ -1878,13 +1920,14 @@ <h2 class="no-num no-toc no-ref" id="contents">Table of Contents</h2>
      <a href="#metadata"><span class="secno">3</span> <span class="content">Metadata</span></a>
      <ol class="toc">
       <li><a href="#axes-md"><span class="secno">3.1</span> <span class="content">"axes" metadata</span></a>
-      <li><a href="#trafo-md"><span class="secno">3.2</span> <span class="content">"coordinateTransformations" metadata</span></a>
-      <li><a href="#multiscale-md"><span class="secno">3.3</span> <span class="content">"multiscales" metadata</span></a>
-      <li><a href="#omero-md"><span class="secno">3.4</span> <span class="content">"omero" metadata</span></a>
-      <li><a href="#labels-md"><span class="secno">3.5</span> <span class="content">"labels" metadata</span></a>
-      <li><a href="#label-md"><span class="secno">3.6</span> <span class="content">"image-label" metadata</span></a>
-      <li><a href="#plate-md"><span class="secno">3.7</span> <span class="content">"plate" metadata</span></a>
-      <li><a href="#well-md"><span class="secno">3.8</span> <span class="content">"well" metadata</span></a>
+      <li><a href="#bf2raw"><span class="secno">3.2</span> <span class="content">"bioformats2raw.layout" (transitional)</span></a>
+      <li><a href="#trafo-md"><span class="secno">3.3</span> <span class="content">"coordinateTransformations" metadata</span></a>
+      <li><a href="#multiscale-md"><span class="secno">3.4</span> <span class="content">"multiscales" metadata</span></a>
+      <li><a href="#omero-md"><span class="secno">3.5</span> <span class="content">"omero" metadata (transitional)</span></a>
+      <li><a href="#labels-md"><span class="secno">3.6</span> <span class="content">"labels" metadata</span></a>
+      <li><a href="#label-md"><span class="secno">3.7</span> <span class="content">"image-label" metadata</span></a>
+      <li><a href="#plate-md"><span class="secno">3.8</span> <span class="content">"plate" metadata</span></a>
+      <li><a href="#well-md"><span class="secno">3.9</span> <span class="content">"well" metadata</span></a>
      </ol>
     <li><a href="#naming-style"><span class="secno">4</span> <span class="content">Specification naming style</span></a>
     <li><a href="#implementations"><span class="secno">5</span> <span class="content">Implementations</span></a>
@@ -1959,6 +2002,16 @@ <h3 class="heading settled" data-level="1.2" id="ome-ngff"><span class="secno">1
 of bioimaging data, whether during acquisition or sharing in the cloud.</p>
    <p class="note" role="note"><span>Note:</span> The following text makes use of OME-Zarr <a data-link-type="biblio" href="#biblio-ome-zarr-py">[ome-zarr-py]</a>, the current prototype implementation,
 for all examples.</p>
+   <h3 class="heading settled" data-level="1.3" id="document-conventions"><span class="secno">1.3. </span><span class="content">Document conventions</span><a class="self-link" href="#document-conventions"></a></h3>
+   <p>The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”,
+“RECOMMENDED”, “MAY”, and “OPTIONAL” are to be interpreted as described in <a href="https://tools.ietf.org/html/rfc2119">RFC 2119</a>.</p>
+   <p> <dfn class="dfn-paneled" data-dfn-type="dfn" data-noexport id="transitional">Transitional</dfn> metadata is added to the specification with the
+intention of removing it in the future. Implementations may be expected (MUST) or
+encouraged (SHOULD) to support the reading of the data, but writing will usually
+be optional (MAY). Examples of transitional metadata include custom additions by
+implementations that are later submitted as a formal specification. (See <a href="#bf2raw">§ 3.2 "bioformats2raw.layout" (transitional)</a>) </p>
+   <p>Some of the JSON examples in this document include commments. However, these are only for
+clarity purposes and comments MUST NOT be included in JSON objects.</p>
    <h2 class="heading settled" data-level="2" id="on-disk"><span class="secno">2. </span><span class="content">On-disk (or in-cloud) layout</span><a class="self-link" href="#on-disk"></a></h2>
    <p>An overview of the layout of an OME-Zarr fileset should make
 understanding the following metadata sections easier. The hierarchy
@@ -1973,7 +2026,7 @@ <h2 class="heading settled" data-level="2" id="on-disk"><span class="secno">2. <
    <h3 class="heading settled" data-level="2.1" id="image-layout"><span class="secno">2.1. </span><span class="content">Images</span><a class="self-link" href="#image-layout"></a></h3>
    <p>The following layout describes the expected Zarr hierarchy for images with
 multiple levels of resolutions and optionally associated labels.
-Note that the number of dimensions is variable between 2 and 5 and that axis names are arbitrary, see <a href="#multiscale-md">§ 3.3 "multiscales" metadata</a> for details.
+Note that the number of dimensions is variable between 2 and 5 and that axis names are arbitrary, see <a href="#multiscale-md">§ 3.4 "multiscales" metadata</a> for details.
 For this example we assume an image with 5 dimensions and axes called <code>t,c,z,y,x</code>.</p>
 <pre>.                             # Root folder, potentially in S3,
 │                             # with a flat list of images by image ID.
@@ -2081,8 +2134,120 @@ <h3 class="heading settled" data-level="3.1" id="axes-md"><span class="secno">3.
        <p>Units for "time" axes: <a class="property css" data-link-type="property">attosecond</a>, <a class="property css" data-link-type="property">centisecond</a>, <a class="property css" data-link-type="property">day</a>, <a class="property css" data-link-type="property">decisecond</a>, <a class="property css" data-link-type="property">exasecond</a>, <a class="property css" data-link-type="property">femtosecond</a>, <a class="property css" data-link-type="property">gigasecond</a>, <a class="property css" data-link-type="property">hectosecond</a>, <a class="property css" data-link-type="property">hour</a>, <a class="property css" data-link-type="property">kilosecond</a>, <a class="property css" data-link-type="property">megasecond</a>, <a class="property css" data-link-type="property">microsecond</a>, <a class="property css" data-link-type="property">millisecond</a>, <a class="property css" data-link-type="property">minute</a>, <a class="property css" data-link-type="property">nanosecond</a>, <a class="property css" data-link-type="property">petasecond</a>, <a class="property css" data-link-type="property">picosecond</a>, <a class="property css" data-link-type="property">second</a>, <a class="property css" data-link-type="property">terasecond</a>, <a class="property css" data-link-type="property">yoctosecond</a>, <a class="property css" data-link-type="property">yottasecond</a>, <a class="property css" data-link-type="property">zeptosecond</a>, <a class="property css" data-link-type="property">zettasecond</a></p>
      </ul>
    </ul>
-   <p>If part of <a href="#multiscale-md">§ 3.3 "multiscales" metadata</a>, the length of "axes" MUST be equal to the number of dimensions of the arrays that contain the image data.</p>
-   <h3 class="heading settled" data-level="3.2" id="trafo-md"><span class="secno">3.2. </span><span class="content">"coordinateTransformations" metadata</span><a class="self-link" href="#trafo-md"></a></h3>
+   <p>If part of <a href="#multiscale-md">§ 3.4 "multiscales" metadata</a>, the length of "axes" MUST be equal to the number of dimensions of the arrays that contain the image data.</p>
+   <h3 class="heading settled" data-level="3.2" id="bf2raw"><span class="secno">3.2. </span><span class="content">"bioformats2raw.layout" (transitional)</span><a class="self-link" href="#bf2raw"></a></h3>
+   <p><a data-link-type="dfn" href="#transitional" id="ref-for-transitional">Transitional</a> "bioformats2raw.layout" metadata identifies a group which implicitly describes a series of images.
+The need for the collection stems from the common "multi-image file" scenario in microscopy. Parsers like Bio-Formats
+define a strict, stable ordering of the images in a single container that can be used to refer to them by other tools.</p>
+   <p>In order to capture that information within an OME-NGFF dataset, <code>bioformats2raw</code> internally introduced a wrapping layer.
+The bioformats2raw layout has been added to v0.4 as a transitional specification to specify filesets that already exist
+in the wild. An upcoming NGFF specification will replace this layout with explicit metadata.</p>
+   <h4 class="no-toc heading settled" data-level="3.2.1" id="bf2raw-layout"><span class="secno">3.2.1. </span><span class="content">Layout</span><a class="self-link" href="#bf2raw-layout"></a></h4>
+   <p>Typical Zarr layout produced by running <code>bioformats2raw</code> on a fileset that contains more than one image (series > 1):</p>
+<pre>series.ome.zarr               # One converted fileset from bioformats2raw
+    ├── .zgroup
+    ├── .zattrs               # Contains "bioformats2raw.layout" metadata
+    ├── OME                   # Special group for containing OME metadata
+    │   ├── .zgroup
+    │   ├── .zattrs           # Contains "series" metadata
+    │   └── METADATA.ome.xml  # OME-XML file stored within the Zarr fileset
+    ├── 0                     # First image in the collection
+    ├── 1                     # Second image in the collection
+    └── ...
+</pre>
+   <h4 class="no-toc heading settled" data-level="3.2.2" id="bf2raw-attributes"><span class="secno">3.2.2. </span><span class="content">Attributes</span><a class="self-link" href="#bf2raw-attributes"></a></h4>
+   <p>The top-level <code>.zattrs</code> file must contain the <code>bioformats2raw.layout</code> key:</p>
+<pre class="include-code highlight"><c- p>{</c->
+  <c- f>"bioformats2raw.layout"</c-> <c- p>:</c-> <c- mi>3</c->
+<c- p>}</c-></pre>
+   <p>If the top-level group represents a plate, the <code>bioformats2raw.layout</code> metadata will be present but
+the "plate" key MUST also be present, takes precedence and parsing of such datasets should follow <a href="#plate-md">§ 3.8 "plate" metadata</a>. It is not
+possible to mix collections of images with plates at present.</p>
+<pre class="include-code highlight"><c- p>{</c->
+  <c- f>"bioformats2raw.layout"</c-> <c- p>:</c-> <c- mi>3</c-><c- p>,</c->
+  <c- f>"plate"</c-> <c- p>:</c-> <c- p>{</c->
+    <c- f>"columns"</c-> <c- p>:</c-> <c- p>[</c-> <c- p>{</c->
+      <c- f>"name"</c-> <c- p>:</c-> <c- u>"1"</c->
+    <c- p>}</c-> <c- p>],</c->
+    <c- f>"name"</c-> <c- p>:</c-> <c- u>"Plate Name 0"</c-><c- p>,</c->
+    <c- f>"wells"</c-> <c- p>:</c-> <c- p>[</c-> <c- p>{</c->
+      <c- f>"path"</c-> <c- p>:</c-> <c- u>"A/1"</c-><c- p>,</c->
+      <c- f>"rowIndex"</c-> <c- p>:</c-> <c- mi>0</c-><c- p>,</c->
+      <c- f>"columnIndex"</c-> <c- p>:</c-> <c- mi>0</c->
+    <c- p>}</c-> <c- p>],</c->
+    <c- f>"field_count"</c-> <c- p>:</c-> <c- mi>1</c-><c- p>,</c->
+    <c- f>"rows"</c-> <c- p>:</c-> <c- p>[</c-> <c- p>{</c->
+      <c- f>"name"</c-> <c- p>:</c-> <c- u>"A"</c->
+    <c- p>}</c-> <c- p>],</c->
+    <c- f>"acquisitions"</c-> <c- p>:</c-> <c- p>[</c-> <c- p>{</c->
+      <c- f>"id"</c-> <c- p>:</c-> <c- mi>0</c->
+    <c- p>}</c-> <c- p>],</c->
+    <c- f>"version"</c-> <c- p>:</c-> <c- u>"0.4"</c->
+  <c- p>}</c->
+<c- p>}</c->
+</pre>
+   <p>The <code>.zattrs</code> file within the OME group may contain the "series" key:</p>
+<pre class="include-code highlight"><c- p>{</c->
+  <c- f>"series"</c-> <c- p>:</c-> <c- p>[</c-> <c- u>"0"</c-><c- p>,</c-> <c- u>"1"</c-> <c- p>]</c->
+<c- p>}</c->
+</pre>
+   <h4 class="no-toc heading settled" data-level="3.2.3" id="bf2raw-details"><span class="secno">3.2.3. </span><span class="content">Details</span><a class="self-link" href="#bf2raw-details"></a></h4>
+   <p>Conforming groups:</p>
+   <ul>
+    <li data-md>
+     <p>MUST have the value "3" for the "bioformats2raw.layout" key in their <code>.zattrs</code> metadata at the top of the hierarchy;</p>
+    <li data-md>
+     <p>SHOULD have OME metadata representing the entire collection of images in a file named "OME/METADATA.ome.xml" which:</p>
+     <ul>
+      <li data-md>
+       <p>MUST adhere to the OME-XML specification but</p>
+      <li data-md>
+       <p>MUST use <code>&lt;MetadataOnly/></code> elements as opposed to <code>&lt;BinData/></code>, <code>&lt;BinaryOnly/></code> or <code>&lt;TiffData/></code>;</p>
+      <li data-md>
+       <p>MAY make use of the <a href="https://docs.openmicroscopy.org/ome-model/6.2.2/specifications/minimum.html">minimum specification</a>.</p>
+     </ul>
+   </ul>
+   <p>Additionally, the logic for finding the Zarr group for each image follows the following logic:</p>
+   <ul>
+    <li data-md>
+     <p>If "plate" metadata is present, images MUST be located at the defined location.</p>
+     <ul>
+      <li data-md>
+       <p>Matching "series" metadata (as described next) SHOULD be provided for tools that are unaware of the "plate" specification.</p>
+     </ul>
+    <li data-md>
+     <p>If the "OME" Zarr group exists, it:</p>
+     <ul>
+      <li data-md>
+       <p>MAY contain a "series" attribute. If so:</p>
+       <ul>
+        <li data-md>
+         <p>"series" MUST be a list of string objects, each of which is a path to an image group.</p>
+        <li data-md>
+         <p>The order of the paths MUST match the order of the "Image" elements in "OME/METADATA.ome.xml" if provided.</p>
+       </ul>
+     </ul>
+    <li data-md>
+     <p>If the "series" attribute does not exist and no "plate" is present:</p>
+     <ul>
+      <li data-md>
+       <p>separate "multiscales" images MUST be stored in consecutively numbered groups starting from 0 (i.e. "0/", "1/", "2/", "3/", ...).</p>
+     </ul>
+    <li data-md>
+     <p>Every "multiscales" group MUST represent exactly one OME-XML "Image" in the same order as either the series index or the group numbers.</p>
+   </ul>
+   <p>Conforming readers:</p>
+   <ul>
+    <li data-md>
+     <p>SHOULD make users aware of the presence of more than one image (i.e. SHOULD NOT default to only opening the first image);</p>
+    <li data-md>
+     <p>MAY use the "series" attribute in the "OME" group to determine a list of valid groups to display;</p>
+    <li data-md>
+     <p>MAY choose to show all images within the collection or offer the user a choice of images, as with <dfn data-dfn-type="dfn" data-export id="hcs"><abbr title="High-content screening">HCS</abbr><a class="self-link" href="#hcs"></a></dfn> plates;</p>
+    <li data-md>
+     <p>MAY ignore other groups or arrays under the root of the hierarchy.</p>
+   </ul>
+   <h3 class="heading settled" data-level="3.3" id="trafo-md"><span class="secno">3.3. </span><span class="content">"coordinateTransformations" metadata</span><a class="self-link" href="#trafo-md"></a></h3>
    <p>"coordinateTransformations" describe a series of transformations that map between two coordinate spaces (defined by "axes").
 For example, to map a discrete data space of an array to the corresponding physical space.
 It is a list of dictionaries. Each entry describes a single transformation and MUST contain the field "type".
@@ -2109,7 +2274,7 @@ <h3 class="heading settled" data-level="3.2" id="trafo-md"><span class="secno">3
       <th>description 
    </table>
    <p>The transformations in the list are applied sequentially and in order.</p>
-   <h3 class="heading settled" data-level="3.3" id="multiscale-md"><span class="secno">3.3. </span><span class="content">"multiscales" metadata</span><a class="self-link" href="#multiscale-md"></a></h3>
+   <h3 class="heading settled" data-level="3.4" id="multiscale-md"><span class="secno">3.4. </span><span class="content">"multiscales" metadata</span><a class="self-link" href="#multiscale-md"></a></h3>
    <p>Metadata about an image can be found under the "multiscales" key in the group-level metadata. Here, image refers to 2 to 5 dimensional data representing image or volumetric data with optional time or channel axes. It is stored in a multiple resolution representation.</p>
    <p>"multiscales" contains a list of dictionaries where each entry describes a multiscale image.</p>
    <p>Each "multiscales" dictionary MUST contain the field "axes", see <a href="#axes-md">§ 3.1 "axes" metadata</a>.
@@ -2122,7 +2287,7 @@ <h3 class="heading settled" data-level="3.3" id="multiscale-md"><span class="sec
 to the current zarr group. The "path"s MUST be ordered from largest (i.e. highest resolution) to smallest.</p>
    <p>Each "datasets" dictionary MUST have the same number of dimensions and MUST NOT have more than 5 dimensions. The number of dimensions and order MUST correspond to number and order of "axes".
 Each dictionary in "datasets" MUST contain the field "coordinateTransformations", which contains a list of transformations that map the data coordinates to the physical coordinates (as specified by "axes") for this resolution level.
-The transformations are defined according to <a href="#trafo-md">§ 3.2 "coordinateTransformations" metadata</a>. The transformation MUST only be of type <code>translation</code> or <code>scale</code>.
+The transformations are defined according to <a href="#trafo-md">§ 3.3 "coordinateTransformations" metadata</a>. The transformation MUST only be of type <code>translation</code> or <code>scale</code>.
 They MUST contain exactly one <code>scale</code> transformation that specifies the pixel size in physical units or time duration. If scaling information is not available or applicable for one of the axes, the value MUST express the scaling factor between the current resolution and the first resolution for the given axis, defaulting to 1.0 if there is no downsampling along the axis.
 It MAY contain exactly one <code>translation</code> that specifies the offset from the origin in physical units. If <code>translation</code> is given it MUST be listed after <code>scale</code> to ensure that it is given in physical coordinates.
 The length of the <code>scale</code> and <code>translation</code> array MUST be the same as the length of "axes".
@@ -2130,47 +2295,63 @@ <h3 class="heading settled" data-level="3.3" id="multiscale-md"><span class="sec
    <p>Each "multiscales" dictionary MAY contain the field "coordinateTransformations", describing transformations that are applied to all resolution levels in the same manner.
 The transformations MUST follow the same rules about allowed types, order, etc. as in "datasets:coordinateTransformations" and are applied after them.
 They can for example be used to specify the <code>scale</code> for a dimension that is the same for all resolutions.</p>
-   <p>Each "multiscales" dictionary SHOULD contain the field "name". It SHOULD contain the field "version", which indicates the version of the multiscale metadata of this image (current version is 0.4).</p>
+   <p>Each "multiscales" dictionary SHOULD contain the field "name". It SHOULD contain the field "version", which indicates the version of the multiscale metadata of this image (current version is 0.5-dev).</p>
    <p>Each "multiscales" dictionary SHOULD contain the field "type", which gives the type of downscaling method used to generate the multiscale image pyramid.
 It SHOULD contain the field "metadata", which contains a dictionary with additional information about the downscaling method.</p>
-<pre>{
-    "multiscales": [
-        {
-            "version": "0.4",
-            "name": "example",
-            "axes": [
-                {"name": "t", "type": "time", "unit": "millisecond"},
-                {"name": "c", "type": "channel"},
-                {"name": "z", "type": "space", "unit": "micrometer"},
-                {"name": "y", "type": "space", "unit": "micrometer"},
-                {"name": "x", "type": "space", "unit": "micrometer"}
-            ],
-            "datasets": [
-                {
-                    "path": "0",
-                    "coordinateTransformations": [{"type": "scale", "scale": [1.0, 1.0, 0.5, 0.5, 0.5]}]  # the voxel size for the first scale level (0.5 micrometer)
-                }
-                {
-                    "path": "1",
-                    "coordinateTransformations": [{"type": "scale", "scale": [1.0, 1.0, 1.0, 1.0, 1.0]}]  # the voxel size for the second scale level (downscaled by a factor of 2 -> 1 micrometer)
-                },
-                {
-                    "path": "2",
-                    "coordinateTransformations": [{"type": "scale", "scale": [1.0, 1.0, 2.0, 2.0, 2.0]}]  # the voxel size for the second scale level (downscaled by a factor of 4 -> 2 micrometer)
-                }
-            ],
-            "coordinateTransformations": [{"type": "scale", "scale": [0.1, 1.0, 1.0, 1.0, 1.0]],  # the time unit (0.1 milliseconds), which is the same for each scale level
-            "type": "gaussian",
-            "metadata": {                                       # the fields in metadata depend on the downscaling implementation
-                "method": "skimage.transform.pyramid_gaussian", # here, the paramters passed to the skimage function are given
-                "version": "0.16.1",
-                "args": "[true]",
-                "kwargs": {"multichannel": true}
-            }
-        }
-    ]
-}
-</pre>
+<pre class="include-code highlight"><c- p>{</c->
+    <c- f>"multiscales"</c-><c- p>:</c-> <c- p>[</c->
+        <c- p>{</c->
+            <c- f>"version"</c-><c- p>:</c-> <c- u>"0.5-dev"</c-><c- p>,</c->
+            <c- f>"name"</c-><c- p>:</c-> <c- u>"example"</c-><c- p>,</c->
+            <c- f>"axes"</c-><c- p>:</c-> <c- p>[</c->
+                <c- p>{</c-><c- f>"name"</c-><c- p>:</c-> <c- u>"t"</c-><c- p>,</c-> <c- f>"type"</c-><c- p>:</c-> <c- u>"time"</c-><c- p>,</c-> <c- f>"unit"</c-><c- p>:</c-> <c- u>"millisecond"</c-><c- p>},</c->
+                <c- p>{</c-><c- f>"name"</c-><c- p>:</c-> <c- u>"c"</c-><c- p>,</c-> <c- f>"type"</c-><c- p>:</c-> <c- u>"channel"</c-><c- p>},</c->
+                <c- p>{</c-><c- f>"name"</c-><c- p>:</c-> <c- u>"z"</c-><c- p>,</c-> <c- f>"type"</c-><c- p>:</c-> <c- u>"space"</c-><c- p>,</c-> <c- f>"unit"</c-><c- p>:</c-> <c- u>"micrometer"</c-><c- p>},</c->
+                <c- p>{</c-><c- f>"name"</c-><c- p>:</c-> <c- u>"y"</c-><c- p>,</c-> <c- f>"type"</c-><c- p>:</c-> <c- u>"space"</c-><c- p>,</c-> <c- f>"unit"</c-><c- p>:</c-> <c- u>"micrometer"</c-><c- p>},</c->
+                <c- p>{</c-><c- f>"name"</c-><c- p>:</c-> <c- u>"x"</c-><c- p>,</c-> <c- f>"type"</c-><c- p>:</c-> <c- u>"space"</c-><c- p>,</c-> <c- f>"unit"</c-><c- p>:</c-> <c- u>"micrometer"</c-><c- p>}</c->
+            <c- p>],</c->
+            <c- f>"datasets"</c-><c- p>:</c-> <c- p>[</c->
+                <c- p>{</c->
+                    <c- f>"path"</c-><c- p>:</c-> <c- u>"0"</c-><c- p>,</c->
+                    <c- f>"coordinateTransformations"</c-><c- p>:</c-> <c- p>[{</c->
+                        // <c- kc>t</c->he voxel size <c- kc>f</c->or <c- kc>t</c->he <c- kc>f</c->irs<c- kc>t</c-> scale level (<c- mf>0.5</c-> microme<c- kc>ter</c->)
+                        <c- f>"type"</c-><c- p>:</c-> <c- u>"scale"</c-><c- p>,</c->
+                        <c- f>"scale"</c-><c- p>:</c-> <c- p>[</c-><c- mf>1.0</c-><c- p>,</c-> <c- mf>1.0</c-><c- p>,</c-> <c- mf>0.5</c-><c- p>,</c-> <c- mf>0.5</c-><c- p>,</c-> <c- mf>0.5</c-><c- p>]</c->
+                    <c- p>}]</c->
+                <c- p>},</c->
+                <c- p>{</c->
+                    <c- f>"path"</c-><c- p>:</c-> <c- u>"1"</c-><c- p>,</c->
+                    <c- f>"coordinateTransformations"</c-><c- p>:</c-> <c- p>[{</c->
+                        // <c- kc>t</c->he voxel size <c- kc>f</c->or <c- kc>t</c->he seco<c- kc>n</c->d scale level (dow<c- kc>ns</c->caled by a <c- kc>fa</c->c<c- kc>t</c->or o<c- kc>f</c-> <c- mi>2</c-> <c- mi>-</c->> <c- mi>1</c-> microme<c- kc>ter</c->)
+                        <c- f>"type"</c-><c- p>:</c-> <c- u>"scale"</c-><c- p>,</c->
+                        <c- f>"scale"</c-><c- p>:</c-> <c- p>[</c-><c- mf>1.0</c-><c- p>,</c-> <c- mf>1.0</c-><c- p>,</c-> <c- mf>1.0</c-><c- p>,</c-> <c- mf>1.0</c-><c- p>,</c-> <c- mf>1.0</c-><c- p>]</c->
+                    <c- p>}]</c->
+                <c- p>},</c->
+                <c- p>{</c->
+                    <c- f>"path"</c-><c- p>:</c-> <c- u>"2"</c-><c- p>,</c->
+                    <c- f>"coordinateTransformations"</c-><c- p>:</c-> <c- p>[{</c->
+                        // <c- kc>t</c->he voxel size <c- kc>f</c->or <c- kc>t</c->he <c- kc>t</c->hird scale level (dow<c- kc>ns</c->caled by a <c- kc>fa</c->c<c- kc>t</c->or o<c- kc>f</c-> <c- mi>4</c-> <c- mi>-</c->> <c- mi>2</c-> microme<c- kc>ter</c->)
+                        <c- f>"type"</c-><c- p>:</c-> <c- u>"scale"</c-><c- p>,</c->
+                        <c- f>"scale"</c-><c- p>:</c-> <c- p>[</c-><c- mf>1.0</c-><c- p>,</c-> <c- mf>1.0</c-><c- p>,</c-> <c- mf>2.0</c-><c- p>,</c-> <c- mf>2.0</c-><c- p>,</c-> <c- mf>2.0</c-><c- p>]</c->
+                    <c- p>}]</c->
+                <c- p>}</c->
+            <c- p>],</c->
+            <c- f>"coordinateTransformations"</c-><c- p>:</c-> <c- p>[{</c->
+                // <c- kc>t</c->he <c- kc>t</c->ime u<c- kc>n</c->i<c- kc>t</c-> (<c- mf>0.1</c-> milliseco<c- kc>n</c->ds)<c- p>,</c-> which is <c- kc>t</c->he same <c- kc>f</c->or each scale level
+                <c- f>"type"</c-><c- p>:</c-> <c- u>"scale"</c-><c- p>,</c->
+                <c- f>"scale"</c-><c- p>:</c-> <c- p>[</c-><c- mf>0.1</c-><c- p>,</c-> <c- mf>1.0</c-><c- p>,</c-> <c- mf>1.0</c-><c- p>,</c-> <c- mf>1.0</c-><c- p>,</c-> <c- mf>1.0</c-><c- p>]</c->
+            <c- p>}],</c->
+            <c- f>"type"</c-><c- p>:</c-> <c- u>"gaussian"</c-><c- p>,</c->
+            <c- f>"metadata"</c-><c- p>:</c-> <c- p>{</c->
+                <c- f>"description"</c-><c- p>:</c-> <c- u>"the fields in metadata depend on the downscaling implementation. Here, the parameters passed to the skimage function are given"</c-><c- p>,</c->
+                <c- f>"method"</c-><c- p>:</c-> <c- u>"skimage.transform.pyramid_gaussian"</c-><c- p>,</c->
+                <c- f>"version"</c-><c- p>:</c-> <c- u>"0.16.1"</c-><c- p>,</c->
+                <c- f>"args"</c-><c- p>:</c-> <c- u>"[true]"</c-><c- p>,</c->
+                <c- f>"kwargs"</c-><c- p>:</c-> <c- p>{</c-><c- f>"multichannel"</c-><c- p>:</c-> <c- kc>true</c-><c- p>}</c->
+            <c- p>}</c->
+        <c- p>}</c->
+    <c- p>]</c->
+<c- p>}</c-></pre>
    <p>If only one multiscale is provided, use it. Otherwise, the user can choose by
 name, using the first multiscale as a fallback:</p>
 <pre class="language-python highlight"><c- n>datasets</c-> <c- o>=</c-> <c- p>[]</c->
@@ -2182,12 +2363,12 @@ <h3 class="heading settled" data-level="3.3" id="multiscale-md"><span class="sec
     <c- c1># Use the first by default. Or perhaps choose based on chunk size.</c->
     <c- n>datasets</c-> <c- o>=</c-> <c- p>[</c-><c- n>x</c-><c- p>[</c-><c- u>"path"</c-><c- p>]</c-> <c- k>for</c-> <c- n>x</c-> <c- ow>in</c-> <c- n>multiscales</c-><c- p>[</c-><c- mi>0</c-><c- p>][</c-><c- u>"datasets"</c-><c- p>]]</c->
 </pre>
-   <h3 class="heading settled" data-level="3.4" id="omero-md"><span class="secno">3.4. </span><span class="content">"omero" metadata</span><a class="self-link" href="#omero-md"></a></h3>
-   <p>Information specific to the channels of an image and how to render it
+   <h3 class="heading settled" data-level="3.5" id="omero-md"><span class="secno">3.5. </span><span class="content">"omero" metadata (transitional)</span><a class="self-link" href="#omero-md"></a></h3>
+   <p><a data-link-type="dfn" href="#transitional" id="ref-for-transitional①">Transitional</a> information specific to the channels of an image and how to render it
 can be found under the "omero" key in the group-level metadata:</p>
 <pre class="language-json highlight"><c- f>"id"</c-><c- p>:</c-> <c- mi>1</c-><c- p>,</c->                              # ID i<c- kc>n</c-> OMERO
 <c- f>"name"</c-><c- p>:</c-> <c- u>"example.tif"</c-><c- p>,</c->                # Name as show<c- kc>n</c-> i<c- kc>n</c-> <c- kc>t</c->he UI
-<c- f>"version"</c-><c- p>:</c-> <c- u>"0.4"</c-><c- p>,</c->                     # Curre<c- kc>nt</c-> versio<c- kc>n</c->
+<c- f>"version"</c-><c- p>:</c-> <c- u>"0.5-dev"</c-><c- p>,</c->                 # Curre<c- kc>nt</c-> versio<c- kc>n</c->
 <c- f>"channels"</c-><c- p>:</c-> <c- p>[</c->                         # Array ma<c- kc>t</c->chi<c- kc>n</c->g <c- kc>t</c->he c dime<c- kc>ns</c->io<c- kc>n</c-> size
     <c- p>{</c->
         <c- f>"active"</c-><c- p>:</c-> <c- kc>true</c-><c- p>,</c->
@@ -2212,7 +2393,7 @@ <h3 class="heading settled" data-level="3.4" id="omero-md"><span class="secno">3
 </pre>
    <p>See https://docs.openmicroscopy.org/omero/5.6.1/developers/Web/WebGateway.html#imgdata
 for more information.</p>
-   <h3 class="heading settled" data-level="3.5" id="labels-md"><span class="secno">3.5. </span><span class="content">"labels" metadata</span><a class="self-link" href="#labels-md"></a></h3>
+   <h3 class="heading settled" data-level="3.6" id="labels-md"><span class="secno">3.6. </span><span class="content">"labels" metadata</span><a class="self-link" href="#labels-md"></a></h3>
    <p>The special group "labels" found under an image Zarr contains the key <code>labels</code> containing
 the paths to label objects which can be found underneath the group:</p>
 <pre class="language-json highlight"><c- p>{</c->
@@ -2222,334 +2403,330 @@ <h3 class="heading settled" data-level="3.5" id="labels-md"><span class="secno">
 <c- p>}</c->
 </pre>
    <p>Unlisted groups MAY be labels.</p>
-   <h3 class="heading settled" data-level="3.6" id="label-md"><span class="secno">3.6. </span><span class="content">"image-label" metadata</span><a class="self-link" href="#label-md"></a></h3>
+   <h3 class="heading settled" data-level="3.7" id="label-md"><span class="secno">3.7. </span><span class="content">"image-label" metadata</span><a class="self-link" href="#label-md"></a></h3>
    <p>Groups containing the <code>image-label</code> dictionary represent an image segmentation
 in which each unique pixel value represents a separate segmented object. <code>image-label</code> groups MUST also contain <code>multiscales</code> metadata and the two
 "datasets" series MUST have the same number of entries.</p>
-   <p>The <code>colors</code> key defines a list of JSON objects describing the unique label
-values. Each entry in the list MUST contain the key "label-value" with the
-pixel value for that label. Additionally, the "rgba" key MAY be present, the
-value for which is an RGBA unsigned-int 4-tuple: <code>[uint8, uint8, uint8, uint8]</code> All <code>label-value</code>s must be unique. Clients who choose to not throw an error
-should ignore all except the _last_ entry.</p>
-   <p>Some implementations may represent overlapping labels by using a specially assigned
+   <p>The <code>image-label</code> dictionary SHOULD contain a <code>colors</code> key whose value MUST be a
+list of JSON objects describing the unique label values. Each color object MUST
+contain the <code>label-value</code> key whose value MUST be an integer specifying the
+pixel value for that label. It MAY contain an <code>rgba</code> key whose value MUST be an array
+of four integers between 0 and 255 <code>[uint8, uint8, uint8, uint8]</code> specifying the label
+color as RGBA. All the values under the <code>label-value</code> key MUST be unique. Clients
+who choose to not throw an error SHOULD ignore all except the _last_ entry.</p>
+   <p>Some implementations MAY represent overlapping labels by using a specially assigned
 value, for example the highest integer available in the pixel range.</p>
-   <p>The <code>properties</code> key defines a list of JSON objects which also describes the unique
-label values. Each entry in the list MUST contain the key "label-value" with the
-pixel value for that label. Additionally, an arbitrary number of key-value pairs
+   <p>The <code>image-label</code> dictionary MAY contain a <code>properties</code> key whose value MUST be a
+list of JSON objects which also describes the unique label values. Each property object
+MUST contain the <code>label-value</code> key whose value MUST be an integer specifying the pixel
+value for that label. Additionally, an arbitrary number of key-value pairs
 MAY be present for each label value denoting associated metadata. Not all label
 values must share the same key-value pairs within the properties list.</p>
-   <p>The <code>source</code> key is an optional dictionary which contains information on the
-image the label is associated with. If included it MAY include a key <code>image</code> whose value is the relative path to a Zarr image group. The default value is
-"../../" since most labels are stored under a subgroup named "labels/" (see
-above).</p>
-<pre class="language-json highlight"><c- f>"image-label"</c-><c- p>:</c->
-  <c- p>{</c->
-    <c- f>"version"</c-><c- p>:</c-> <c- u>"0.4"</c-><c- p>,</c->
+   <p>The <code>image-label</code> dictionary MAY contain a <code>source</code> key whose value MUST be a JSON
+object containing information on the image the label is associated with. If included,
+it MAY include a key <code>image</code> whose value MUST be a string specifying the relative
+path to a Zarr image group. The default value is "../../" since most labels are stored
+under a subgroup named "labels/" (see above).</p>
+   <p>The <code>image-label</code> dictionary SHOULD contain a <code>version</code> key whose value MUST be a string
+specifying the version of the image-label specification.</p>
+<pre class="include-code highlight"><c- p>{</c->
+  <c- f>"image-label"</c-><c- p>:</c-> <c- p>{</c->
+    <c- f>"version"</c-><c- p>:</c-> <c- u>"0.5-dev"</c-><c- p>,</c->
     <c- f>"colors"</c-><c- p>:</c-> <c- p>[</c->
       <c- p>{</c->
         <c- f>"label-value"</c-><c- p>:</c-> <c- mi>1</c-><c- p>,</c->
-        <c- f>"rgba"</c-><c- p>:</c-> <c- p>[</c-><c- mi>255</c-><c- p>,</c-> <c- mi>255</c-><c- p>,</c-> <c- mi>255</c-><c- p>,</c-> <c- mi>0</c-><c- p>]</c->
+        <c- f>"rgba"</c-><c- p>:</c-> <c- p>[</c-><c- mi>255</c-><c- p>,</c-> <c- mi>255</c-><c- p>,</c-> <c- mi>255</c-><c- p>,</c-> <c- mi>255</c-><c- p>]</c->
       <c- p>},</c->
       <c- p>{</c->
         <c- f>"label-value"</c-><c- p>:</c-> <c- mi>4</c-><c- p>,</c->
         <c- f>"rgba"</c-><c- p>:</c-> <c- p>[</c-><c- mi>0</c-><c- p>,</c-> <c- mi>255</c-><c- p>,</c-> <c- mi>255</c-><c- p>,</c-> <c- mi>128</c-><c- p>]</c->
-      <c- p>},</c->
-      ...
-      <c- p>],</c->
+      <c- p>}</c->
+    <c- p>],</c->
     <c- f>"properties"</c-><c- p>:</c-> <c- p>[</c->
       <c- p>{</c->
         <c- f>"label-value"</c-><c- p>:</c-> <c- mi>1</c-><c- p>,</c->
         <c- f>"area (pixels)"</c-><c- p>:</c-> <c- mi>1200</c-><c- p>,</c->
         <c- f>"class"</c-><c- p>:</c-> <c- u>"foo"</c->
-
       <c- p>},</c->
       <c- p>{</c->
         <c- f>"label-value"</c-><c- p>:</c-> <c- mi>4</c-><c- p>,</c->
         <c- f>"area (pixels)"</c-><c- p>:</c-> <c- mi>1650</c->
-      <c- p>},</c->
-      ...
-      <c- p>]</c->
-  <c- p>},</c->
-  <c- f>"source"</c-><c- p>:</c-> <c- p>{</c->
-    <c- f>"image"</c-><c- p>:</c-> <c- u>"../../"</c->
+      <c- p>}</c->
+    <c- p>],</c->
+    <c- f>"source"</c-><c- p>:</c-> <c- p>{</c->
+      <c- f>"image"</c-><c- p>:</c-> <c- u>"../../"</c->
+    <c- p>}</c->
   <c- p>}</c->
-<c- p>]</c->
+<c- p>}</c->
 </pre>
-   <h3 class="heading settled" data-level="3.7" id="plate-md"><span class="secno">3.7. </span><span class="content">"plate" metadata</span><a class="self-link" href="#plate-md"></a></h3>
+   <h3 class="heading settled" data-level="3.8" id="plate-md"><span class="secno">3.8. </span><span class="content">"plate" metadata</span><a class="self-link" href="#plate-md"></a></h3>
    <p>For high-content screening datasets, the plate layout can be found under the
-custom attributes of the plate group under the <code>plate</code> key.</p>
-   <dl>
-    <dt><strong>acquisitions</strong>
-    <dd>An optional list of JSON objects defining the acquisitions for a given
-      plate. Each acquisition object MUST contain an <code>id</code> key providing an
-      unique identifier within the context of the plate to which fields of
-      view can refer to. It SHOULD contain  a <code>name</code> key identifying the name
-      of the acquisition. It SHOULD contain a <code>maximumfieldcount</code> key
-      indicating the maximum number of fields of view for the acquisition. It
-      MAY contain a <code>description</code> key providing a description for the
-      acquisition. It MAY contain a <code>startime</code> and/or <code>endtime</code> key specifying
-      the start and/or end timestamp of the acquisition using an epoch
-      string.
-    <dt><strong>columns</strong>
-    <dd>A list of JSON objects defining the columns of the plate. Each column
-      object defines the properties of the column at the index of the object
-      in the list. Each column in the physical plate MUST be defined, even
-      if no wells in the column are defined. Each defined column MUST contain
-      a <code>name</code> key specifying the column name. The <code>name</code> MUST contain only
-      alphanumeric characters, MUST be case-sensitive, and MUST NOT be a
-      duplicate of any other <code>name</code> in the <code>columns</code> list. Care SHOULD be
-      taken to avoid collisions on case-insensitive filesystems
-      (e.g. avoid using both <code>Aa</code> and <code>aA</code>).
-    <dt><strong>field_count</strong>
-    <dd>An integer defining the maximum number of fields per view across all
-      wells.
-    <dt><strong>name</strong>
-    <dd>A string defining the name of the plate.
-    <dt><strong>rows</strong>
-    <dd>A list of JSON objects defining the rows of the plate. Each row object
-      defines the properties of the row at the index of the object in the
-      list. Each row in the physical plate MUST be defined, even if no wells
-      in the row are defined. Each defined row MUST contain a <code>name</code> key
-      specifying the row name. The <code>name</code> MUST contain only alphanumeric
-      characters, MUST be case-sensitive, and MUST NOT be a duplicate
-      of any other <code>name</code> in the <code>rows</code> list. Care SHOULD be taken to avoid
-      collisions on case-insensitive filesystems (e.g. avoid using both <code>Aa</code> and <code>aA</code>).
-    <dt><strong>version</strong>
-    <dd>A string defining the version of the specification.
-    <dt><strong>wells</strong>
-    <dd>A list of JSON objects defining the wells of the plate. Each well object
-      MUST contain a <code>path</code> key identifying the path to the well subgroup.
-      The <code>path</code> MUST consist of a <code>name</code> in the <code>rows</code> list, a file separator (<code>/</code>),
-      and a <code>name</code> from the <code>columns</code> list, in that order. The <code>path</code> MUST NOT contain
-      additional leading or trailing directories.
-      Each well object MUST contain both a <code>rowIndex</code> key identifying the index into
-      the <code>rows</code> list and a <code>columnIndex</code> key indentifying the index into
-      the <code>columns</code> list. <code>rowIndex</code> and <code>columnIndex</code> MUST be 0-based.
-      The <code>rowIndex</code>, <code>columnIndex</code>, and <code>path</code> MUST all refer to the same
-      row/column pair.
-   </dl>
+custom attributes of the plate group under the <code>plate</code> key in the group-level metadata.</p>
+   <p>The <code>plate</code> dictionary MAY contain an <code>acquisitions</code> key whose value MUST be a list of
+JSON objects defining the acquisitions for a given plate to which wells can refer to. Each
+acquisition object MUST contain an <code>id</code> key whose value MUST be an unique integer identifier
+greater than or equal to 0 within the context of the plate to which fields of view can refer
+to (see #well-md).
+Each acquisition object SHOULD contain a <code>name</code> key whose value MUST be a string identifying
+the name of the acquisition. Each acquisition object SHOULD contain a <code>maximumfieldcount</code> key whose value MUST be a positive integer indicating the maximum number of fields of view for the
+acquisition. Each acquisition object MAY contain a <code>description</code> key whose value MUST be a
+string specifying a description for the acquisition. Each acquisition object MAY contain
+a <code>starttime</code> and/or <code>endtime</code> key whose values MUST be integer epoch timestamps specifying
+the start and/or end timestamp of the acquisition.</p>
+   <p>The <code>plate</code> dictionary MUST contain a <code>columns</code> key whose value MUST be a list of JSON objects
+defining the columns of the plate. Each column object defines the properties of
+the column at the index of the object in the list. Each column in the physical plate
+MUST be defined, even if no wells in the column are defined. Each column object MUST
+contain a <code>name</code> key whose value is a string specifying the column name. The <code>name</code> MUST
+contain only alphanumeric characters, MUST be case-sensitive, and MUST NOT be a duplicate of any
+other <code>name</code> in the <code>columns</code> list. Care SHOULD be taken to avoid collisions on
+case-insensitive filesystems (e.g. avoid using both <code>Aa</code> and <code>aA</code>).</p>
+   <p>The <code>plate</code> dictionary SHOULD contain a <code>field_count</code> key whose value MUST be a positive integer
+defining the maximum number of fields per view across all wells.</p>
+   <p>The <code>plate</code> dictionary SHOULD contain a <code>name</code> key whose value MUST be a string defining the
+name of the plate.</p>
+   <p>The <code>plate</code> dictionary MUST contain a <code>rows</code> key whose value MUST be a list of JSON objects
+defining the rows of the plate. Each row object defines the properties of
+the row at the index of the object in the list. Each row in the physical plate
+MUST be defined, even if no wells in the row are defined. Each defined row MUST
+contain a <code>name</code> key whose value MUST be a string defining the row name. The <code>name</code> MUST
+contain only alphanumeric characters, MUST be case-sensitive, and MUST NOT be a duplicate of any
+other <code>name</code> in the <code>rows</code> list. Care SHOULD be taken to avoid collisions on
+case-insensitive filesystems (e.g. avoid using both <code>Aa</code> and <code>aA</code>).</p>
+   <p>The <code>plate</code> dictionary SHOULD contain a <code>version</code> key whose value MUST be a string specifying the
+version of the plate specification.</p>
+   <p>The <code>plate</code> dictionary MUST contain a <code>wells</code> key whose value MUST be a list of JSON objects
+defining the wells of the plate. Each well object MUST contain a <code>path</code> key whose value MUST
+be a string specifying the path to the well subgroup. The <code>path</code> MUST consist of a <code>name</code> in
+the <code>rows</code> list, a file separator (<code>/</code>), and a <code>name</code> from the <code>columns</code> list, in that order.
+The <code>path</code> MUST NOT contain additional leading or trailing directories.
+Each well object MUST contain both a <code>rowIndex</code> key whose value MUST be an integer identifying
+the index into the <code>rows</code> list and a <code>columnIndex</code> key whose value MUST be an integer indentifying
+the index into the <code>columns</code> list. <code>rowIndex</code> and <code>columnIndex</code> MUST be 0-based. The <code>rowIndex</code>, <code>columnIndex</code>, and <code>path</code> MUST all refer to the same row/column pair.</p>
    <p>For example the following JSON object defines a plate with two acquisitions and
 6 wells (2 rows and 3 columns), containing up to 2 fields of view per acquisition.</p>
-<pre class="language-json highlight"><c- f>"plate"</c-><c- p>:</c-> <c- p>{</c->
-    <c- f>"acquisitions"</c-><c- p>:</c-> <c- p>[</c->
-        <c- p>{</c->
-            <c- f>"id"</c-><c- p>:</c-> <c- mi>1</c-><c- p>,</c->
-            <c- f>"maximumfieldcount"</c-><c- p>:</c-> <c- mi>2</c-><c- p>,</c->
-            <c- f>"name"</c-><c- p>:</c-> <c- u>"Meas_01(2012-07-31_10-41-12)"</c-><c- p>,</c->
-            <c- f>"starttime"</c-><c- p>:</c-> <c- mi>1343731272000</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"id"</c-><c- p>:</c-> <c- mi>2</c-><c- p>,</c->
-            <c- f>"maximumfieldcount"</c-><c- p>:</c-> <c- mi>2</c-><c- p>,</c->
-            <c- f>"name"</c-><c- p>:</c-> <c- u>"Meas_02(201207-31_11-56-41)"</c-><c- p>,</c->
-            <c- f>"starttime"</c-><c- p>:</c-> <c- mi>1343735801000</c->
-        <c- p>}</c->
-    <c- p>],</c->
-    <c- f>"columns"</c-><c- p>:</c-> <c- p>[</c->
-        <c- p>{</c->
-            <c- f>"name"</c-><c- p>:</c-> <c- u>"1"</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"name"</c-><c- p>:</c-> <c- u>"2"</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"name"</c-><c- p>:</c-> <c- u>"3"</c->
-        <c- p>}</c->
-    <c- p>],</c->
-    <c- f>"field_count"</c-><c- p>:</c-> <c- mi>4</c-><c- p>,</c->
-    <c- f>"name"</c-><c- p>:</c-> <c- u>"test"</c-><c- p>,</c->
-    <c- f>"rows"</c-><c- p>:</c-> <c- p>[</c->
-        <c- p>{</c->
-            <c- f>"name"</c-><c- p>:</c-> <c- u>"A"</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"name"</c-><c- p>:</c-> <c- u>"B"</c->
-        <c- p>}</c->
-    <c- p>],</c->
-    <c- f>"version"</c-><c- p>:</c-> <c- u>"0.4"</c-><c- p>,</c->
-    <c- f>"wells"</c-><c- p>:</c-> <c- p>[</c->
-        <c- p>{</c->
-            <c- f>"path"</c-><c- p>:</c-> <c- u>"A/1"</c-><c- p>,</c->
-            <c- f>"rowIndex"</c-><c- p>:</c-> <c- mi>0</c-><c- p>,</c->
-            <c- f>"columnIndex"</c-><c- p>:</c-> <c- mi>0</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"path"</c-><c- p>:</c-> <c- f>"A/2"</c->
-            <c- f>"rowIndex"</c-><c- p>:</c-> <c- mi>0</c-><c- p>,</c->
-            <c- f>"columnIndex"</c-><c- p>:</c-> <c- mi>1</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"path"</c-><c- p>:</c-> <c- f>"A/3"</c->
-            <c- f>"rowIndex"</c-><c- p>:</c-> <c- mi>0</c-><c- p>,</c->
-            <c- f>"columnIndex"</c-><c- p>:</c-> <c- mi>2</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"path"</c-><c- p>:</c-> <c- f>"B/1"</c->
-            <c- f>"rowIndex"</c-><c- p>:</c-> <c- mi>1</c-><c- p>,</c->
-            <c- f>"columnIndex"</c-><c- p>:</c-> <c- mi>0</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"path"</c-><c- p>:</c-> <c- f>"B/2"</c->
-            <c- f>"rowIndex"</c-><c- p>:</c-> <c- mi>1</c-><c- p>,</c->
-            <c- f>"columnIndex"</c-><c- p>:</c-> <c- mi>1</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"path"</c-><c- p>:</c-> <c- f>"B/3"</c->
-            <c- f>"rowIndex"</c-><c- p>:</c-> <c- mi>1</c-><c- p>,</c->
-            <c- f>"columnIndex"</c-><c- p>:</c-> <c- mi>2</c->
-        <c- p>}</c->
-    <c- p>]</c->
-  <c- p>}</c->
+<pre class="include-code highlight"><c- p>{</c->
+    <c- f>"plate"</c-><c- p>:</c-> <c- p>{</c->
+        <c- f>"acquisitions"</c-><c- p>:</c-> <c- p>[</c->
+            <c- p>{</c->
+                <c- f>"id"</c-><c- p>:</c-> <c- mi>1</c-><c- p>,</c->
+                <c- f>"maximumfieldcount"</c-><c- p>:</c-> <c- mi>2</c-><c- p>,</c->
+                <c- f>"name"</c-><c- p>:</c-> <c- u>"Meas_01(2012-07-31_10-41-12)"</c-><c- p>,</c->
+                <c- f>"starttime"</c-><c- p>:</c-> <c- mi>1343731272000</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"id"</c-><c- p>:</c-> <c- mi>2</c-><c- p>,</c->
+                <c- f>"maximumfieldcount"</c-><c- p>:</c-> <c- mi>2</c-><c- p>,</c->
+                <c- f>"name"</c-><c- p>:</c-> <c- u>"Meas_02(201207-31_11-56-41)"</c-><c- p>,</c->
+                <c- f>"starttime"</c-><c- p>:</c-> <c- mi>1343735801000</c->
+            <c- p>}</c->
+        <c- p>],</c->
+        <c- f>"columns"</c-><c- p>:</c-> <c- p>[</c->
+            <c- p>{</c->
+                <c- f>"name"</c-><c- p>:</c-> <c- u>"1"</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"name"</c-><c- p>:</c-> <c- u>"2"</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"name"</c-><c- p>:</c-> <c- u>"3"</c->
+            <c- p>}</c->
+        <c- p>],</c->
+        <c- f>"field_count"</c-><c- p>:</c-> <c- mi>4</c-><c- p>,</c->
+        <c- f>"name"</c-><c- p>:</c-> <c- u>"test"</c-><c- p>,</c->
+        <c- f>"rows"</c-><c- p>:</c-> <c- p>[</c->
+            <c- p>{</c->
+                <c- f>"name"</c-><c- p>:</c-> <c- u>"A"</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"name"</c-><c- p>:</c-> <c- u>"B"</c->
+            <c- p>}</c->
+        <c- p>],</c->
+        <c- f>"version"</c-><c- p>:</c-> <c- u>"0.5-dev"</c-><c- p>,</c->
+        <c- f>"wells"</c-><c- p>:</c-> <c- p>[</c->
+            <c- p>{</c->
+                <c- f>"path"</c-><c- p>:</c-> <c- u>"A/1"</c-><c- p>,</c->
+                <c- f>"rowIndex"</c-><c- p>:</c-> <c- mi>0</c-><c- p>,</c->
+                <c- f>"columnIndex"</c-><c- p>:</c-> <c- mi>0</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"path"</c-><c- p>:</c-> <c- u>"A/2"</c-><c- p>,</c->
+                <c- f>"rowIndex"</c-><c- p>:</c-> <c- mi>0</c-><c- p>,</c->
+                <c- f>"columnIndex"</c-><c- p>:</c-> <c- mi>1</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"path"</c-><c- p>:</c-> <c- u>"A/3"</c-><c- p>,</c->
+                <c- f>"rowIndex"</c-><c- p>:</c-> <c- mi>0</c-><c- p>,</c->
+                <c- f>"columnIndex"</c-><c- p>:</c-> <c- mi>2</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"path"</c-><c- p>:</c-> <c- u>"B/1"</c-><c- p>,</c->
+                <c- f>"rowIndex"</c-><c- p>:</c-> <c- mi>1</c-><c- p>,</c->
+                <c- f>"columnIndex"</c-><c- p>:</c-> <c- mi>0</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"path"</c-><c- p>:</c-> <c- u>"B/2"</c-><c- p>,</c->
+                <c- f>"rowIndex"</c-><c- p>:</c-> <c- mi>1</c-><c- p>,</c->
+                <c- f>"columnIndex"</c-><c- p>:</c-> <c- mi>1</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"path"</c-><c- p>:</c-> <c- u>"B/3"</c-><c- p>,</c->
+                <c- f>"rowIndex"</c-><c- p>:</c-> <c- mi>1</c-><c- p>,</c->
+                <c- f>"columnIndex"</c-><c- p>:</c-> <c- mi>2</c->
+            <c- p>}</c->
+        <c- p>]</c->
+    <c- p>}</c->
+<c- p>}</c->
 </pre>
    <p>The following JSON object defines a sparse plate with one acquisition and
 2 wells in a 96 well plate, containing one field of view per acquisition.</p>
-<pre class="language-json highlight"><c- f>"plate"</c-><c- p>:</c-> <c- p>{</c->
-    <c- f>"acquisitions"</c-><c- p>:</c-> <c- p>[</c->
-        <c- p>{</c->
-            <c- f>"id"</c-><c- p>:</c-> <c- mi>1</c-><c- p>,</c->
-            <c- f>"maximumfieldcount"</c-><c- p>:</c-> <c- mi>1</c-><c- p>,</c->
-            <c- f>"name"</c-><c- p>:</c-> <c- u>"single acquisition"</c-><c- p>,</c->
-            <c- f>"starttime"</c-><c- p>:</c-> <c- mi>1343731272000</c->
-        <c- p>},</c->
-    <c- p>],</c->
-    <c- f>"columns"</c-><c- p>:</c-> <c- p>[</c->
-        <c- p>{</c->
-            <c- f>"name"</c-><c- p>:</c-> <c- u>"1"</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"name"</c-><c- p>:</c-> <c- u>"2"</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"name"</c-><c- p>:</c-> <c- u>"3"</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"name"</c-><c- p>:</c-> <c- u>"4"</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"name"</c-><c- p>:</c-> <c- u>"5"</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"name"</c-><c- p>:</c-> <c- u>"6"</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"name"</c-><c- p>:</c-> <c- u>"7"</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"name"</c-><c- p>:</c-> <c- u>"8"</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"name"</c-><c- p>:</c-> <c- u>"9"</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"name"</c-><c- p>:</c-> <c- u>"10"</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"name"</c-><c- p>:</c-> <c- u>"11"</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"name"</c-><c- p>:</c-> <c- u>"12"</c->
-        <c- p>}</c->
-    <c- p>],</c->
-    <c- f>"field_count"</c-><c- p>:</c-> <c- mi>1</c-><c- p>,</c->
-    <c- f>"name"</c-><c- p>:</c-> <c- u>"sparse test"</c-><c- p>,</c->
-    <c- f>"rows"</c-><c- p>:</c-> <c- p>[</c->
-        <c- p>{</c->
-            <c- f>"name"</c-><c- p>:</c-> <c- u>"A"</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"name"</c-><c- p>:</c-> <c- u>"B"</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"name"</c-><c- p>:</c-> <c- u>"C"</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"name"</c-><c- p>:</c-> <c- u>"D"</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"name"</c-><c- p>:</c-> <c- u>"E"</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"name"</c-><c- p>:</c-> <c- u>"F"</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"name"</c-><c- p>:</c-> <c- u>"G"</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"name"</c-><c- p>:</c-> <c- u>"H"</c->
-        <c- p>}</c->
-    <c- p>],</c->
-    <c- f>"version"</c-><c- p>:</c-> <c- u>"0.1"</c-><c- p>,</c->
-    <c- f>"wells"</c-><c- p>:</c-> <c- p>[</c->
-        <c- p>{</c->
-            <c- f>"path"</c-><c- p>:</c-> <c- f>"C/5"</c->
-            <c- f>"rowIndex"</c-><c- p>:</c-> <c- mi>2</c-><c- p>,</c->
-            <c- f>"columnIndex"</c-><c- p>:</c-> <c- mi>4</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"path"</c-><c- p>:</c-> <c- f>"D/7"</c->
-            <c- f>"rowIndex"</c-><c- p>:</c-> <c- mi>3</c-><c- p>,</c->
-            <c- f>"columnIndex"</c-><c- p>:</c-> <c- mi>6</c->
-        <c- p>}</c->
-    <c- p>]</c->
-  <c- p>}</c->
+<pre class="include-code highlight"><c- p>{</c->
+    <c- f>"plate"</c-><c- p>:</c-> <c- p>{</c->
+        <c- f>"acquisitions"</c-><c- p>:</c-> <c- p>[</c->
+            <c- p>{</c->
+                <c- f>"id"</c-><c- p>:</c-> <c- mi>1</c-><c- p>,</c->
+                <c- f>"maximumfieldcount"</c-><c- p>:</c-> <c- mi>1</c-><c- p>,</c->
+                <c- f>"name"</c-><c- p>:</c-> <c- u>"single acquisition"</c-><c- p>,</c->
+                <c- f>"starttime"</c-><c- p>:</c-> <c- mi>1343731272000</c->
+            <c- p>}</c->
+        <c- p>],</c->
+        <c- f>"columns"</c-><c- p>:</c-> <c- p>[</c->
+            <c- p>{</c->
+                <c- f>"name"</c-><c- p>:</c-> <c- u>"1"</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"name"</c-><c- p>:</c-> <c- u>"2"</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"name"</c-><c- p>:</c-> <c- u>"3"</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"name"</c-><c- p>:</c-> <c- u>"4"</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"name"</c-><c- p>:</c-> <c- u>"5"</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"name"</c-><c- p>:</c-> <c- u>"6"</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"name"</c-><c- p>:</c-> <c- u>"7"</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"name"</c-><c- p>:</c-> <c- u>"8"</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"name"</c-><c- p>:</c-> <c- u>"9"</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"name"</c-><c- p>:</c-> <c- u>"10"</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"name"</c-><c- p>:</c-> <c- u>"11"</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"name"</c-><c- p>:</c-> <c- u>"12"</c->
+            <c- p>}</c->
+        <c- p>],</c->
+        <c- f>"field_count"</c-><c- p>:</c-> <c- mi>1</c-><c- p>,</c->
+        <c- f>"name"</c-><c- p>:</c-> <c- u>"sparse test"</c-><c- p>,</c->
+        <c- f>"rows"</c-><c- p>:</c-> <c- p>[</c->
+            <c- p>{</c->
+                <c- f>"name"</c-><c- p>:</c-> <c- u>"A"</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"name"</c-><c- p>:</c-> <c- u>"B"</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"name"</c-><c- p>:</c-> <c- u>"C"</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"name"</c-><c- p>:</c-> <c- u>"D"</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"name"</c-><c- p>:</c-> <c- u>"E"</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"name"</c-><c- p>:</c-> <c- u>"F"</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"name"</c-><c- p>:</c-> <c- u>"G"</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"name"</c-><c- p>:</c-> <c- u>"H"</c->
+            <c- p>}</c->
+        <c- p>],</c->
+        <c- f>"version"</c-><c- p>:</c-> <c- u>"0.5-dev"</c-><c- p>,</c->
+        <c- f>"wells"</c-><c- p>:</c-> <c- p>[</c->
+            <c- p>{</c->
+                <c- f>"path"</c-><c- p>:</c-> <c- u>"C/5"</c-><c- p>,</c->
+                <c- f>"rowIndex"</c-><c- p>:</c-> <c- mi>2</c-><c- p>,</c->
+                <c- f>"columnIndex"</c-><c- p>:</c-> <c- mi>4</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"path"</c-><c- p>:</c-> <c- u>"D/7"</c-><c- p>,</c->
+                <c- f>"rowIndex"</c-><c- p>:</c-> <c- mi>3</c-><c- p>,</c->
+                <c- f>"columnIndex"</c-><c- p>:</c-> <c- mi>6</c->
+            <c- p>}</c->
+        <c- p>]</c->
+    <c- p>}</c->
+<c- p>}</c->
 </pre>
-   <h3 class="heading settled" data-level="3.8" id="well-md"><span class="secno">3.8. </span><span class="content">"well" metadata</span><a class="self-link" href="#well-md"></a></h3>
+   <h3 class="heading settled" data-level="3.9" id="well-md"><span class="secno">3.9. </span><span class="content">"well" metadata</span><a class="self-link" href="#well-md"></a></h3>
    <p>For high-content screening datasets, the metadata about all fields of views
 under a given well can be found under the "well" key in the attributes of the
 well group.</p>
-   <dl>
-    <dt><strong>images</strong>
-    <dd>A list of JSON objects defining the fields of views for a given well.
-      Each object MUST contain a <code>path</code> key identifying the path to the
-      field of view. If multiple acquisitions were performed in the plate, it
-      MUST contain an <code>acquisition</code> key identifying the id of the
-      acquisition which must match one of acquisition JSON objects defined in
-      the plate metadata.
-    <dt><strong>version</strong>
-    <dd>A string defining the version of the specification.
-   </dl>
+   <p>The <code>well</code> dictionary MUST contain an <code>images</code> key whose value MUST be a list of JSON objects
+specifying all fields of views for a given well. Each image object MUST contain a <code>path</code> key whose value MUST be a string specifying the path to the field of view. The <code>path</code> MUST contain only alphanumeric characters, MUST be case-sensitive, and MUST NOT be a duplicate
+of any other <code>path</code> in the <code>images</code> list. If multiple acquisitions were performed in the plate,
+it MUST contain an <code>acquisition</code> key whose value MUST be an integer identifying the acquisition
+which MUST match one of the acquisition JSON objects defined in the plate metadata (see #plate-md).</p>
+   <p>The <code>well</code> dictionary SHOULD contain a <code>version</code> key whose value MUST be a string specifying the
+version of the well specification.</p>
    <p>For example the following JSON object defines a well with four fields of
 view. The first two fields of view were part of the first acquisition while
 the last two fields of view were part of the second acquisition.</p>
-<pre class="language-json highlight"><c- f>"well"</c-><c- p>:</c-> <c- p>{</c->
-    <c- f>"images"</c-><c- p>:</c-> <c- p>[</c->
-        <c- p>{</c->
-            <c- f>"acquisition"</c-><c- p>:</c-> <c- mi>1</c-><c- p>,</c->
-            <c- f>"path"</c-><c- p>:</c-> <c- u>"0"</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"acquisition"</c-><c- p>:</c-> <c- mi>1</c-><c- p>,</c->
-            <c- f>"path"</c-><c- p>:</c-> <c- u>"1"</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"acquisition"</c-><c- p>:</c-> <c- mi>2</c-><c- p>,</c->
-            <c- f>"path"</c-><c- p>:</c-> <c- u>"2"</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"acquisition"</c-><c- p>:</c-> <c- mi>2</c-><c- p>,</c->
-            <c- f>"path"</c-><c- p>:</c-> <c- u>"3"</c->
-        <c- p>}</c->
-    <c- p>],</c->
-    <c- f>"version"</c-><c- p>:</c-> <c- u>"0.4"</c->
-  <c- p>}</c->
-</pre>
+<pre class="include-code highlight"><c- p>{</c->
+    <c- f>"well"</c-><c- p>:</c-> <c- p>{</c->
+        <c- f>"images"</c-><c- p>:</c-> <c- p>[</c->
+            <c- p>{</c->
+                <c- f>"acquisition"</c-><c- p>:</c-> <c- mi>1</c-><c- p>,</c->
+                <c- f>"path"</c-><c- p>:</c-> <c- u>"0"</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"acquisition"</c-><c- p>:</c-> <c- mi>1</c-><c- p>,</c->
+                <c- f>"path"</c-><c- p>:</c-> <c- u>"1"</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"acquisition"</c-><c- p>:</c-> <c- mi>2</c-><c- p>,</c->
+                <c- f>"path"</c-><c- p>:</c-> <c- u>"2"</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"acquisition"</c-><c- p>:</c-> <c- mi>2</c-><c- p>,</c->
+                <c- f>"path"</c-><c- p>:</c-> <c- u>"3"</c->
+            <c- p>}</c->
+        <c- p>],</c->
+        <c- f>"version"</c-><c- p>:</c-> <c- u>"0.5-dev"</c->
+    <c- p>}</c->
+<c- p>}</c-></pre>
    <p>The following JSON object defines a well with two fields of view in a plate with
 four acquisitions. The first field is part of the first acquisition, and the second
 field is part of the last acquisition.</p>
-<pre class="language-json highlight"><c- f>"well"</c-><c- p>:</c-> <c- p>{</c->
-    <c- f>"images"</c-><c- p>:</c-> <c- p>[</c->
-        <c- p>{</c->
-            <c- f>"acquisition"</c-><c- p>:</c-> <c- mi>0</c-><c- p>,</c->
-            <c- f>"path"</c-><c- p>:</c-> <c- u>"0"</c->
-        <c- p>},</c->
-        <c- p>{</c->
-            <c- f>"acquisition"</c-><c- p>:</c-> <c- mi>3</c-><c- p>,</c->
-            <c- f>"path"</c-><c- p>:</c-> <c- u>"1"</c->
-        <c- p>}</c->
-    <c- p>],</c->
-    <c- f>"version"</c-><c- p>:</c-> <c- u>"0.1"</c->
-<c- p>}</c->
-</pre>
+<pre class="include-code highlight"><c- p>{</c->
+    <c- f>"well"</c-><c- p>:</c-> <c- p>{</c->
+        <c- f>"images"</c-><c- p>:</c-> <c- p>[</c->
+            <c- p>{</c->
+                <c- f>"acquisition"</c-><c- p>:</c-> <c- mi>0</c-><c- p>,</c->
+                <c- f>"path"</c-><c- p>:</c-> <c- u>"0"</c->
+            <c- p>},</c->
+            <c- p>{</c->
+                <c- f>"acquisition"</c-><c- p>:</c-> <c- mi>3</c-><c- p>,</c->
+                <c- f>"path"</c-><c- p>:</c-> <c- u>"1"</c->
+            <c- p>}</c->
+        <c- p>],</c->
+        <c- f>"version"</c-><c- p>:</c-> <c- u>"0.5-dev"</c->
+    <c- p>}</c->
+<c- p>}</c-></pre>
    <h2 class="heading settled" data-level="4" id="naming-style"><span class="secno">4. </span><span class="content">Specification naming style</span><a class="self-link" href="#naming-style"></a></h2>
    <p>Multi-word keys in this specification should use the <code>camelCase</code> style.
 NB: some parts of the specification don’t obey this convention as they
@@ -2589,6 +2766,10 @@ <h2 class="heading settled" data-level="7" id="history"><span class="secno">7. <
       <td>Date
       <td>Description
     <tbody>
+     <tr>
+      <td>0.4.1
+      <td>2022-09-26
+      <td>transitional metadata for image collections ("bioformats2raw.layout")
      <tr>
       <td>0.4.0
       <td>2022-02-08
@@ -2652,7 +2833,7 @@ <h3 class="no-ref no-num heading settled" id="w3c-conventions"><span class="cont
     and are set apart from the normative text
     with <code>class="note"</code>,
     like this: </p>
-   <p class="note" role="note">Note, this is an informative note. </p>
+   <p class="note" role="note">Note, this is an informative note.</p>
    <h3 class="no-ref no-num heading settled" id="w3c-conformant-algorithms"><span class="content">Conformant Algorithms</span><a class="self-link" href="#w3c-conformant-algorithms"></a></h3>
    <p>Requirements phrased in the imperative as part of algorithms
     (such as "strip any leading space characters"
@@ -2672,8 +2853,10 @@ <h3 class="no-ref no-num heading settled" id="w3c-conformant-algorithms"><span c
   <h2 class="no-num no-ref heading settled" id="index"><span class="content">Index</span><a class="self-link" href="#index"></a></h2>
   <h3 class="no-num no-ref heading settled" id="index-defined-here"><span class="content">Terms defined by this specification</span><a class="self-link" href="#index-defined-here"></a></h3>
   <ul class="index">
+   <li><a href="#hcs">HCS</a><span>, in § 3.2.3</span>
    <li><a href="#hdf5">HDF5</a><span>, in § 1.1</span>
    <li><a href="#ngff">NGFF</a><span>, in § 1.1</span>
+   <li><a href="#transitional">Transitional</a><span>, in § 1.3</span>
   </ul>
   <h2 class="no-num no-ref heading settled" id="references"><span class="content">References</span><a class="self-link" href="#references"></a></h2>
   <h3 class="no-num no-ref heading settled" id="normative"><span class="content">Normative References</span><a class="self-link" href="#normative"></a></h3>
@@ -2689,4 +2872,67 @@ <h3 class="no-num no-ref heading settled" id="informative"><span class="content"
    <dd>OME; et al. <a href="https://doi.org/10.5281/zenodo.4113931"><cite>ome-zarr-py: Experimental implementation of next-generation file format (NGFF) specifications for storing bioimaging data in the cloud.</cite></a>. 06 October 2020. Informational. URL: <a href="https://doi.org/10.5281/zenodo.4113931">https://doi.org/10.5281/zenodo.4113931</a>
    <dt id="biblio-zarr">[ZARR]
    <dd>Alistair Miles; et al. <a href="https://doi.org/10.5281/zenodo.4069231"><cite>Zarr: An implementation of chunked, compressed, N-dimensional arrays for Python.</cite></a>. 06 October 2020. Informational. URL: <a href="https://doi.org/10.5281/zenodo.4069231">https://doi.org/10.5281/zenodo.4069231</a>
-  </dl>
\ No newline at end of file
+  </dl>
+  <aside class="dfn-panel" data-for="transitional">
+   <b><a href="#transitional">#transitional</a></b><b>Referenced in:</b>
+   <ul>
+    <li><a href="#ref-for-transitional">3.2. "bioformats2raw.layout" (transitional)</a>
+    <li><a href="#ref-for-transitional①">3.5. "omero" metadata (transitional)</a>
+   </ul>
+  </aside>
+<script>/* script-dfn-panel */
+
+document.body.addEventListener("click", function(e) {
+    var queryAll = function(sel) { return [].slice.call(document.querySelectorAll(sel)); }
+    // Find the dfn element or panel, if any, that was clicked on.
+    var el = e.target;
+    var target;
+    var hitALink = false;
+    while(el.parentElement) {
+        if(el.tagName == "A") {
+            // Clicking on a link in a <dfn> shouldn't summon the panel
+            hitALink = true;
+        }
+        if(el.classList.contains("dfn-paneled")) {
+            target = "dfn";
+            break;
+        }
+        if(el.classList.contains("dfn-panel")) {
+            target = "dfn-panel";
+            break;
+        }
+        el = el.parentElement;
+    }
+    if(target != "dfn-panel") {
+        // Turn off any currently "on" or "activated" panels.
+        queryAll(".dfn-panel.on, .dfn-panel.activated").forEach(function(el){
+            el.classList.remove("on");
+            el.classList.remove("activated");
+        });
+    }
+    if(target == "dfn" && !hitALink) {
+        // open the panel
+        var dfnPanel = document.querySelector(".dfn-panel[data-for='" + el.id + "']");
+        if(dfnPanel) {
+            dfnPanel.classList.add("on");
+            var rect = el.getBoundingClientRect();
+            dfnPanel.style.left = window.scrollX + rect.right + 5 + "px";
+            dfnPanel.style.top = window.scrollY + rect.top + "px";
+            var panelRect = dfnPanel.getBoundingClientRect();
+            var panelWidth = panelRect.right - panelRect.left;
+            if(panelRect.right > document.body.scrollWidth && (rect.left - (panelWidth + 5)) > 0) {
+                // Reposition, because the panel is overflowing
+                dfnPanel.style.left = window.scrollX + rect.left - (panelWidth + 5) + "px";
+            }
+        } else {
+            console.log("Couldn't find .dfn-panel[data-for='" + el.id + "']");
+        }
+    } else if(target == "dfn-panel") {
+        // Switch it to "activated" state, which pins it.
+        el.classList.add("activated");
+        el.style.left = null;
+        el.style.top = null;
+    }
+
+});
+</script>
\ No newline at end of file
diff --git a/latest/schemas/image.schema b/latest/schemas/image.schema
new file mode 100644
index 00000000..3926c4f4
--- /dev/null
+++ b/latest/schemas/image.schema
@@ -0,0 +1,233 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://ngff.openmicroscopy.org/latest/schemas/image.schema",
+  "title": "NGFF Image",
+  "description": "JSON from OME-NGFF .zattrs",
+  "type": "object",
+  "properties": {
+    "multiscales": {
+      "description": "The multiscale datasets for this image",
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string"
+          },
+          "datasets": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+              "type": "object",
+              "properties": {
+                "path": {
+                  "type": "string"
+                },
+                "coordinateTransformations": {
+                  "$ref": "#/$defs/coordinateTransformations"
+                }
+              },
+              "required": ["path", "coordinateTransformations"]
+            }
+          },
+          "version": {
+            "type": "string",
+            "enum": [
+              "0.5-dev"
+            ]
+          },
+          "axes": {
+            "$ref": "#/$defs/axes"
+          },
+          "coordinateTransformations": {
+            "$ref": "#/$defs/coordinateTransformations"
+                }
+        },
+        "required": [
+          "datasets", "axes"
+        ]
+      },
+      "minItems": 1,
+      "uniqueItems": true
+    },
+    "omero": {
+      "type": "object",
+      "properties": {
+        "channels": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "window": {
+                "type": "object",
+                "properties": {
+                  "end": {
+                    "type": "number"
+                  },
+                  "max": {
+                    "type": "number"
+                  },
+                  "min": {
+                    "type": "number"
+                  },
+                  "start": {
+                    "type": "number"
+                  }
+                },
+                "required": [
+                  "start",
+                  "min",
+                  "end",
+                  "max"
+                ]
+              },
+              "label": {
+                "type": "string"
+              },
+              "family": {
+                "type": "string"
+              },
+              "color": {
+                "type": "string"
+              },
+              "active": {
+                "type": "boolean"
+              }
+            },
+            "required": [
+              "window",
+              "color"
+            ]
+          }
+        }
+      },
+      "required": [
+        "channels"
+      ]
+    }
+  },
+  "required": [ "multiscales" ],
+
+  "$defs": {
+    "axes": {
+      "type": "array",
+      "uniqueItems": true,
+      "minItems": 2,
+      "maxItems": 5,
+      "contains": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string"
+          },
+          "type": {
+            "type": "string",
+            "enum": ["space"]
+          },
+          "units": {
+            "type": "string"
+          }
+        }
+      },
+      "minContains": 2,
+      "maxContains": 3,
+      "items": {
+        "oneOf": [
+          {
+            "type": "object",
+            "properties": {
+              "name": {
+                "type": "string"
+              },
+              "type": {
+                "type": "string",
+                "enum": ["channel", "time", "space"]
+              }
+            },
+            "required": ["name", "type"]
+          },
+          {
+            "type": "object",
+            "properties": {
+              "name": {
+                "type": "string"
+              },
+              "type": {
+                "type": "string",
+                "not": {
+                  "enum": ["space", "time", "channel"]
+                }
+              }
+            },
+            "required": ["name"]
+          }
+        ]
+      }
+    },
+    "coordinateTransformations": {
+      "type": "array",
+      "minItems": 1,
+      "contains": {
+        "type": "object",
+        "properties": {
+          "type": {
+            "type": "string",
+            "enum": [
+              "scale"
+            ]
+          },
+          "scale": {
+            "type": "array",
+            "minItems": 2,
+            "items": {
+              "type": "number"
+            }
+          }
+        }
+      },
+      "maxContains": 1,
+      "items": {
+        "oneOf": [
+          {
+            "type": "object",
+            "properties": {
+              "type": {
+                "type": "string",
+                "enum": [
+                  "scale"
+                ]
+              },
+              "scale": {
+                "type": "array",
+                "minItems": 2,
+                "items": {
+                  "type": "number"
+                }
+              }
+            },
+            "required": ["type", "scale"]
+          },
+          {
+            "type": "object",
+            "properties": {
+              "type": {
+                "type": "string",
+                "enum": [
+                  "translation"
+                ]
+              },
+              "translation": {
+                "type": "array",
+                "minItems": 2,
+                "items": {
+                  "type": "number"
+                }
+              }
+            },
+            "required": ["type", "translation"]
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/latest/schemas/label.schema b/latest/schemas/label.schema
new file mode 100644
index 00000000..8b23d577
--- /dev/null
+++ b/latest/schemas/label.schema
@@ -0,0 +1,77 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://ngff.openmicroscopy.org/latest/schemas/label.schema",
+  "title": "OME-NGFF labelled image schema",
+  "description": "JSON from OME-NGFF .zattrs",
+  "type": "object",
+  "properties": {
+    "image-label": {
+      "type": "object",
+      "properties": {
+        "colors": {
+          "description": "The colors for this label image",
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "label-value": {
+                "description": "The value of the label",
+                "type": "number"
+              },
+              "rgba": {
+                "description": "The RGBA color stored as an array of four integers between 0 and 255",
+                "type": "array",
+                "items": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 255
+                },
+                "minItems": 4,
+                "maxItems": 4
+              }
+            },
+            "required": [
+              "label-value"
+            ]
+          },
+          "minItems": 1,
+          "uniqueItems": true
+        },
+        "properties": {
+          "description": "The properties for this label image",
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "label-value": {
+                "description": "The pixel value for this label",
+                "type": "integer"
+              }
+            },
+            "required": [
+              "label-value"
+            ]
+          },
+          "minItems": 1,
+          "uniqueItems": true
+        },
+        "source": {
+          "description": "The source of this label image",
+          "type": "object",
+          "properties": {
+            "image": {
+              "type": "string"
+            }
+          }
+        },
+        "version": {
+          "description": "The version of the specification",
+          "type": "string",
+          "enum": [
+            "0.5-dev"
+          ]
+        }
+      }
+    }
+  }
+}
diff --git a/latest/schemas/plate.schema b/latest/schemas/plate.schema
new file mode 100644
index 00000000..099f5bb4
--- /dev/null
+++ b/latest/schemas/plate.schema
@@ -0,0 +1,140 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://ngff.openmicroscopy.org/0.4/schemas/plate.schema",
+  "title": "OME-NGFF plate schema",
+  "description": "JSON from OME-NGFF .zattrs",
+  "type": "object",
+  "properties": {
+    "plate": {
+      "type": "object",
+      "properties": {
+        "acquisitions": {
+          "description": "The acquisitions for this plate",
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "description": "A unique identifier within the context of the plate",
+                "type": "integer",
+                "minimum": 0
+              },
+              "maximumfieldcount": {
+                "description": "The maximum number of fields of view for the acquisition",
+                "type": "integer",
+                "exclusiveMinimum": 0
+              },
+              "name": {
+                "description": "The name of the acquisition",
+                "type": "string"
+              },
+              "description": {
+                "description": "The description of the acquisition",
+                "type": "string"
+              },
+              "starttime": {
+                "description": "The start timestamp of the acquisition, expressed as epoch time i.e. the number seconds since the Epoch",
+                "type": "integer",
+                "minimum": 0
+              },
+              "endtime": {
+                "description": "The end timestamp of the acquisition, expressed as epoch time i.e. the number seconds since the Epoch",
+                "type": "integer",
+                "minimum": 0
+              }
+            },
+            "required": [
+              "id"
+            ]
+          }
+        },
+        "version": {
+          "description": "The version of the specification",
+          "type": "string",
+          "enum": [
+            "0.5-dev"
+          ]
+        },
+        "field_count": {
+          "description": "The maximum number of fields per view across all wells",
+          "type": "integer",
+          "exclusiveMinimum": 0
+        },
+        "name": {
+          "description": "The name of the plate",
+          "type": "string"
+        },
+        "columns": {
+          "description": "The columns of the plate",
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "name": {
+                "description": "The column name",
+                "type": "string",
+                "pattern": "^[A-Za-z0-9]+$"
+              }
+            },
+            "required": [
+              "name"
+            ]
+          },
+          "minItems": 1,
+          "uniqueItems": true
+        },
+        "rows": {
+          "description": "The rows of the plate",
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "name": {
+                "description": "The row name",
+                "type": "string",
+                "pattern": "^[A-Za-z0-9]+$"
+              }
+            },
+            "required": [
+              "name"
+            ]
+          },
+          "minItems": 1,
+          "uniqueItems": true
+        },
+        "wells": {
+          "description": "The wells of the plate",
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "path": {
+                "description": "The path to the well subgroup",
+                "type": "string",
+                "pattern": "^[A-Za-z0-9]+/[A-Za-z0-9]+$"
+              },
+              "rowIndex": {
+                "description": "The index of the well in the rows list",
+                "type": "integer",
+                "minimum": 0
+              },
+              "columnIndex": {
+                "description": "The index of the well in the columns list",
+                "type": "integer",
+                "minimum": 0
+              }
+            },
+            "required": [
+              "path", "rowIndex", "columnIndex"
+            ]
+          },
+          "minItems": 1,
+          "uniqueItems": true
+        }
+      },
+      "required": [
+        "columns", "rows", "wells"
+      ]
+    }
+  }
+}
diff --git a/latest/schemas/strict_image.schema b/latest/schemas/strict_image.schema
new file mode 100644
index 00000000..bcecc003
--- /dev/null
+++ b/latest/schemas/strict_image.schema
@@ -0,0 +1,19 @@
+{
+  "$id": "https://ngff.openmicroscopy.org/latest/schemas/strict_image.schema",
+  "allOf": [
+    {
+      "$ref": "https://ngff.openmicroscopy.org/latest/schemas/image.schema"
+    },
+    {
+      "properties": {
+        "multiscales": {
+          "items": {
+            "required": [
+              "version", "metadata", "type", "name"
+            ]
+          }
+        }
+      }
+    }
+  ]
+}
\ No newline at end of file
diff --git a/latest/schemas/strict_label.schema b/latest/schemas/strict_label.schema
new file mode 100644
index 00000000..c52dd51b
--- /dev/null
+++ b/latest/schemas/strict_label.schema
@@ -0,0 +1,18 @@
+{
+  "$id": "https://ngff.openmicroscopy.org/latest/schemas/strict_label.schema",
+  "allOf": [
+    {
+      "$ref": "https://ngff.openmicroscopy.org/latest/schemas/label.schema"
+    },
+    {
+      "properties": {
+        "image-label": {
+          "required": [
+            "version",
+            "colors"
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/latest/schemas/strict_plate.schema b/latest/schemas/strict_plate.schema
new file mode 100644
index 00000000..5a88ab72
--- /dev/null
+++ b/latest/schemas/strict_plate.schema
@@ -0,0 +1,28 @@
+{
+  "$id": "https://ngff.openmicroscopy.org/0.4/schemas/strict_plate.schema",
+  "allOf": [
+    {
+      "$ref": "https://ngff.openmicroscopy.org/0.4/schemas/plate.schema"
+    },
+    {
+      "properties": {
+        "plate": {
+          "properties": {
+            "acquisitions": {
+              "items": {
+                "required": [
+                  "name",
+                  "maximumfieldcount"
+                ]
+              }
+            }
+          },
+          "required": [
+            "name",
+            "version"
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/latest/schemas/strict_well.schema b/latest/schemas/strict_well.schema
new file mode 100644
index 00000000..1e200294
--- /dev/null
+++ b/latest/schemas/strict_well.schema
@@ -0,0 +1,17 @@
+{
+  "$id": "https://ngff.openmicroscopy.org/0.4/schemas/strict_well.schema",
+  "allOf": [
+    {
+      "$ref": "https://ngff.openmicroscopy.org/0.4/schemas/well.schema"
+    },
+    {
+      "properties": {
+        "well": {
+          "required": [
+            "version"
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/latest/schemas/well.schema b/latest/schemas/well.schema
new file mode 100644
index 00000000..891abd05
--- /dev/null
+++ b/latest/schemas/well.schema
@@ -0,0 +1,47 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://ngff.openmicroscopy.org/0.4/schemas/well.schema",
+  "title": "OME-NGFF well schema",
+  "description": "JSON from OME-NGFF .zattrs",
+  "type": "object",
+  "properties": {
+    "well": {
+      "type": "object",
+      "properties": {
+        "images": {
+          "description": "The fields of view for this well",
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "acquisition": {
+                "description": "A unique identifier within the context of the plate",
+                "type": "integer"
+              },
+              "path": {
+                "description": "The path for this field of view subgroup",
+                "type": "string",
+                "pattern": "^[A-Za-z0-9]+$"
+              }
+            },
+            "required": [
+              "path"
+            ]
+          },
+          "minItems": 1,
+          "uniqueItems": true
+        },
+        "version": {
+          "description": "The version of the specification",
+          "type": "string",
+          "enum": [
+            "0.5-dev"
+          ]
+        }
+      },
+      "required": [
+        "images"
+      ]
+    }
+  }
+}