zarr-developers · maxrjones · Jun 6, 2025 · Jun 6, 2025 · Jun 6, 2025 · Jun 6, 2025
diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
@@ -3,7 +3,7 @@
 TODO:
 * [ ] Add unit tests and/or doctests in docstrings
 * [ ] Add docstrings and API docs for any new/modified user-facing classes and functions
-* [ ] New/modified features documented in `docs/user-guide/*.rst`
+* [ ] New/modified features documented in `docs/user-guide/*.md`
 * [ ] Changes documented as a new file in `changes/`
 * [ ] GitHub Actions have all passed
 * [ ] Test coverage is 100% (Codecov passes)
diff --git a/.github/labeler.yml b/.github/labeler.yml
@@ -1,4 +1,4 @@
 needs release notes:
   - all:
     - changed-files:
-      - all-globs-to-all-files: '!changes/*.rst'
+      - all-globs-to-all-files: '!changes/*.md'
diff --git a/.gitignore b/.gitignore
@@ -49,9 +49,9 @@ coverage.xml
 # Django stuff:
 *.log
 
-# Sphinx documentation
+# Documentation
+site/
 docs/_build/
-docs/api
 docs/data
 data
 data.zip

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
@@ -20,6 +20,7 @@ repos:
     rev: v5.0.0
     hooks:
       - id: check-yaml
+        exclude: mkdocs.yml
       - id: trailing-whitespace
   - repo: https://github.com/pre-commit/mirrors-mypy
     rev: v1.16.1

diff --git a/.readthedocs.yaml b/.readthedocs.yaml
@@ -12,11 +12,8 @@ build:
           towncrier build --version Unreleased --yes;
         fi
 
-sphinx:
-  configuration: docs/conf.py
-  fail_on_warning: true
-
-formats: all
+mkdocs:
+  configuration: mkdocs.yml
 
 python:
    install:

diff --git a/changes/2774.feature.rst → changes/2774.feature.md b/changes/2774.feature.rst → changes/2774.feature.md
diff --git a/changes/2871.feature.rst → changes/2871.feature.md b/changes/2871.feature.rst → changes/2871.feature.md
diff --git a/changes/2874.feature.rst → changes/2874.feature.md b/changes/2874.feature.rst → changes/2874.feature.md
@@ -6,4 +6,4 @@ variable-length string data type, but the old metadata representation can still
 used when reading arrays. The logic for automatically choosing the chunk encoding for a given data
 type has also changed, and this necessitated changes to the ``config`` API.
 
-For more on this new feature, see the `documentation </user-guide/data_types.html>`_
+For more on this new feature, see the [documentation](user-guide/data_types.md
diff --git a/changes/2921.bugfix.rst → changes/2921.bugfix.md b/changes/2921.bugfix.rst → changes/2921.bugfix.md
diff --git a/changes/3021.feature.rst → changes/3021.feature.md b/changes/3021.feature.rst → changes/3021.feature.md
diff --git a/changes/3066.feature.rst → changes/3066.feature.md b/changes/3066.feature.rst → changes/3066.feature.md
diff --git a/changes/3081.feature.rst → changes/3081.feature.md b/changes/3081.feature.rst → changes/3081.feature.md
diff --git a/changes/3082.feature.rst → changes/3082.feature.md b/changes/3082.feature.rst → changes/3082.feature.md
diff --git a/changes/3100.bugfix.rst → changes/3100.bugfix.md b/changes/3100.bugfix.rst → changes/3100.bugfix.md
diff --git a/changes/3103.bugfix.rst → changes/3103.bugfix.md b/changes/3103.bugfix.rst → changes/3103.bugfix.md
diff --git a/changes/3127.bugfix.rst → changes/3127.bugfix.md b/changes/3127.bugfix.rst → changes/3127.bugfix.md
diff --git a/changes/3128.bugfix.rst → changes/3128.bugfix.md b/changes/3128.bugfix.rst → changes/3128.bugfix.md
@@ -1 +1 @@
-Fix `zarr.open` default for argument `mode` when `store` is `read_only`
+Fix `zarr.open` default for argument `mode` when `store` is `read_only`.
diff --git a/changes/3130.feature.md b/changes/3130.feature.md
@@ -0,0 +1 @@
+Port more stateful testing actions from [Icechunk](https://icechunk.io).
diff --git a/changes/3130.feature.rst b/changes/3130.feature.rst
diff --git a/changes/3138.feature.rst → changes/3138.feature.md b/changes/3138.feature.rst → changes/3138.feature.md
diff --git a/changes/3140.bugfix.rst → changes/3140.bugfix.md b/changes/3140.bugfix.rst → changes/3140.bugfix.md
diff --git a/changes/3156.bugfix.rst → changes/3156.bugfix.md b/changes/3156.bugfix.rst → changes/3156.bugfix.md
diff --git a/changes/3170.bugfix.rst → changes/3170.bugfix.md b/changes/3170.bugfix.rst → changes/3170.bugfix.md
diff --git a/changes/README.md b/changes/README.md
@@ -1,7 +1,7 @@
 Writing a changelog entry
 -------------------------
 
-Please put a new file in this directory named `xxxx.<type>.rst`, where
+Please put a new file in this directory named `xxxx.<type>.md`, where
 
 - `xxxx` is the pull request number associated with this entry
 - `<type>` is one of:

diff --git a/docs/Makefile b/docs/Makefile
Original file line number	Diff line number	Diff line change
		@@ -1 +1 @@
		Fix `zarr.open` default for argument `mode` when `store` is `read_only`
		Fix `zarr.open` default for argument `mode` when `store` is `read_only`.
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		Port more stateful testing actions from [Icechunk](https://icechunk.io).