From 6a700556aeeb4bdacf1075b3d6cdcb3ba56c7fbc Mon Sep 17 00:00:00 2001
From: Max Jones <14077947+maxrjones@users.noreply.github.com>
Date: Tue, 23 Jun 2026 16:16:04 -0400
Subject: [PATCH] docs: mark ZEP0003 as Superseded by zarr-extensions
 rectilinear chunk grid

---
 {draft => superseded}/ZEP0003.md | 17 ++++++++++++++---
 superseded/superseded_zeps.md    | 12 ++++++++++++
 2 files changed, 26 insertions(+), 3 deletions(-)
 rename {draft => superseded}/ZEP0003.md (89%)
 create mode 100644 superseded/superseded_zeps.md

diff --git a/draft/ZEP0003.md b/superseded/ZEP0003.md
similarity index 89%
rename from draft/ZEP0003.md
rename to superseded/ZEP0003.md
index 9884598..23f1829 100644
--- a/draft/ZEP0003.md
+++ b/superseded/ZEP0003.md
@@ -2,8 +2,10 @@
 layout: default
 title: ZEP0003
 description: Variable chunk sizes
-parent: draft ZEPs
-nav_order: 3
+parent: superseded ZEPs
+nav_order: 1
+
+redirect_from: /draft/ZEP0003
 ---
 
 # ZEP 3 — Variable chunking
@@ -12,14 +14,23 @@ Authors:
 * Martin Durant ([@martindurant](https://github.com/martindurant)), Anaconda, Inc.
 * Isaac Virshup ([@ivirshup](https://github.com/martindurant)), Helmholtz Munich
 
-Status: Draft
+Status: Superseded
 
 Type: Specification
 
 Created: 2022-10-17
 
+Replaced-By: [zarr-extensions `rectilinear` chunk grid](https://github.com/zarr-developers/zarr-extensions/tree/main/chunk-grids/rectilinear)
+
 Discussion: https://github.com/orgs/zarr-developers/discussions/52
 
+> **Note:** This ZEP has been **superseded**. Variable (rectangular) chunking is
+> now specified for Zarr v3 as the
+> [`rectilinear` chunk grid](https://github.com/zarr-developers/zarr-extensions/tree/main/chunk-grids/rectilinear)
+> in the [zarr-extensions](https://github.com/zarr-developers/zarr-extensions)
+> repository, which is the mechanism that replaced per-feature specification ZEPs.
+> The original proposal is retained below for historical reference.
+
 ## Abstract
 
 To allow the chunks of a zarr array to be rectangular grid rather than a regular grid, 
diff --git a/superseded/superseded_zeps.md b/superseded/superseded_zeps.md
new file mode 100644
index 0000000..3676b66
--- /dev/null
+++ b/superseded/superseded_zeps.md
@@ -0,0 +1,12 @@
+---
+layout: default
+title: superseded ZEPs
+description: List of Superseded ZEPs
+nav_order: 5
+has_children: true
+permalink: /superseded_zeps/
+---
+
+# Superseded ZEPs
+
+### Shows the list of Superseded ZEPs.