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/.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/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/3068.bugfix.rst → changes/3068.bugfix.md b/changes/3068.bugfix.rst → changes/3068.bugfix.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/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
diff --git a/docs/_static/custom.css b/docs/_static/custom.css