Merge branch 'main' into fix-pcodec-compression

Author: d-v-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)

.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'

.github/workflows/test.yml

@@ -129,11 +129,11 @@ jobs:
         pip install hatch
     - name: Set Up Hatch Env
       run: |
-        hatch env create doctest
-        hatch env run -e doctest list-env
+        hatch env create docs
+        hatch env run -e docs list-env
     - name: Run Tests
       run: |
-        hatch env run --env doctest run
+        hatch env run --env docs check
 
   test-complete:
     name: Test complete

.gitignore

@@ -49,9 +49,9 @@ coverage.xml
 # Django stuff:
 *.log
 
-# Sphinx documentation
+# Documentation
+site/
 docs/_build/
-docs/api
 docs/data
 data
 data.zip

.pre-commit-config.yaml

@@ -6,7 +6,7 @@ ci:
 default_stages: [pre-commit, pre-push]
 repos:
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.12.11
+    rev: v0.13.1
     hooks:
       - id: ruff-check
         args: ["--fix", "--show-fixes"]
@@ -20,9 +20,10 @@ repos:
     rev: v6.0.0
     hooks:
       - id: check-yaml
+        exclude: mkdocs.yml
       - id: trailing-whitespace
   - repo: https://github.com/pre-commit/mirrors-mypy
-    rev: v1.17.1
+    rev: v1.18.2
     hooks:
       - id: mypy
         files: src|tests

.readthedocs.yaml

@@ -11,16 +11,16 @@ build:
         then
           towncrier build --version Unreleased --yes;
         fi
-
-sphinx:
-  configuration: docs/conf.py
-  fail_on_warning: true
-
-formats: all
+    build:
+        html:
+          - mkdocs build --strict --site-dir $READTHEDOCS_OUTPUT/html
+mkdocs:
+  configuration: mkdocs.yml
 
 python:
    install:
    - method: pip
      path: .
      extra_requirements:
         - docs
+        - remote

changes/1798.feature.rst

@@ -0,0 +1 @@
+Use mkdocs-material for Zarr-Python documentation