diff --git a/.readthedocs.yaml b/.readthedocs.yaml
index d7190b4771..d407808e78 100644
--- a/.readthedocs.yaml
+++ b/.readthedocs.yaml
@@ -4,6 +4,9 @@ build:
   os: ubuntu-20.04
   tools:
     python: "3.11"
+  jobs:
+    post_checkout:
+      - git fetch --unshallow || true
 
 sphinx:
   configuration: docs/conf.py
diff --git a/docs/conf.py b/docs/conf.py
index f900a74520..31dc7da204 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -73,8 +73,8 @@
 copyright = "2024, Zarr Developers"
 author = "Zarr Developers"
 
-version = get_version("zarr")
 release = get_version("zarr")
+version = get_version("zarr")
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.
diff --git a/pyproject.toml b/pyproject.toml
index 9776de7bf4..abc825162c 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,5 +1,5 @@
 [build-system]
-requires = ["setuptools>=64.0.0", "setuptools-scm>1.5.4"]
+requires = ["setuptools>=64", "setuptools-scm>8"]
 build-backend = "setuptools.build_meta"
 
 
@@ -68,9 +68,8 @@ packages = ["zarr", "zarr._storage", "zarr.tests"]
 license-files = ["LICENSE.txt"]
 
 [tool.setuptools_scm]
-version_scheme = "guess-next-dev"
 local_scheme = "dirty-tag"
-write_to = "zarr/version.py"
+version_file = "zarr/version.py"
 
 [tool.ruff]
 line-length = 100