diff --git a/dev-python/pytest-steps/files/pytest-steps-1.8.0-strict-mkdocs.patch b/dev-python/pytest-steps/files/pytest-steps-1.8.0-strict-mkdocs.patch
new file mode 100644
index 0000000000..b9b833a46a
--- /dev/null
+++ b/dev-python/pytest-steps/files/pytest-steps-1.8.0-strict-mkdocs.patch
@@ -0,0 +1,20 @@
+https://www.mkdocs.org/about/release-notes/#stricter-directory-validation
+
+diff --git a/docs/mkdocs.yml b/mkdocs.yml
+similarity index 95%
+rename from docs/mkdocs.yml
+rename to mkdocs.yml
+index 8359d3f..b4c34c4 100644
+--- a/docs/mkdocs.yml
++++ b/mkdocs.yml
+@@ -1,8 +1,8 @@
+ site_name: pytest_steps
+ # site_description: 'A short description of my project'
+ repo_url: https://github.com/smarie/python-pytest-steps
+-docs_dir: .
+-site_dir: ../site
++docs_dir: ./docs
++site_dir: ./site
+ nav:
+     - Home: index.md
+     - API reference: api_reference.md
diff --git a/dev-python/pytest-steps/pytest-steps-1.8.0.ebuild b/dev-python/pytest-steps/pytest-steps-1.8.0.ebuild
index 8d813d0651..57301eca54 100644
--- a/dev-python/pytest-steps/pytest-steps-1.8.0.ebuild
+++ b/dev-python/pytest-steps/pytest-steps-1.8.0.ebuild
@@ -1,15 +1,14 @@
-# Copyright 2022-2023 Gentoo Authors
+# Copyright 2022-2024 Gentoo Authors
 # Distributed under the terms of the GNU General Public License v2
 
 EAPI=8
 
-PYTHON_COMPAT=( python3_{10..11} )
+PYTHON_COMPAT=( python3_{10..12} )
 DISTUTILS_USE_PEP517=setuptools
 PYPI_NO_NORMALIZE=1
 
 DOCS_BUILDER="mkdocs"
 DOCS_DEPEND="dev-python/mkdocs-material"
-DOCS_DIR="docs"
 
 inherit distutils-r1 docs pypi
 
@@ -35,6 +34,8 @@ BDEPEND="
 	)
 "
 
+PATCHES=( "${FILESDIR}/${P}-strict-mkdocs.patch" )
+
 EPYTEST_DESELECT=(
 	# tests fail with recent Pandas
 	pytest_steps/tests/test_docs_example_with_harvest.py::test_synthesis_df