Migrate documentation theme to PyData Sphinx theme

.readthedocs.yaml

@@ -18,11 +18,8 @@ build:
     python: "3.10"
   jobs:
     post_create_environment:
-      # Install poetry
-      # https://python-poetry.org/docs/#installing-manually
-      - pip install poetry
+      # Install uv
+      - pip install uv
     post_install:
-      # Install dependencies with 'docs' dependency group
-      # https://python-poetry.org/docs/managing-dependencies/#dependency-groups
-      # VIRTUAL_ENV needs to be set manually for now, see #11150
-      - VIRTUAL_ENV=$READTHEDOCS_VIRTUALENV_PATH poetry install
+      # Install dependencies with 'docs' dependency group using uv
+      - uv sync --group docs --frozen --no-group dev

docs/source/conf.py

@@ -38,6 +38,19 @@
 # -- Options for HTML output -------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output
 
-html_theme = "sphinx_rtd_theme"
+html_theme = "pydata_sphinx_theme"
 master_doc = "index"
 html_static_path = []
+
+# Theme options
+html_theme_options = {
+    "github_url": "https://github.com/DanielAvdar/pandas-pyarrow",
+    "use_edit_page_button": True,
+}
+
+html_context = {
+    "github_user": "DanielAvdar",
+    "github_repo": "pandas-pyarrow",
+    "github_version": "main",
+    "doc_path": "docs/source",
+}

pyproject.toml

@@ -83,7 +83,7 @@ dev = [
 docs = [
     "sphinx>=8.2.0; python_version >= '3.11'",
     "sphinx>=7.0.0; python_version < '3.11'",
-    "sphinx-rtd-theme>=3.0.2",
+    "pydata-sphinx-theme>=0.13.0",
 ]
 
 [tool.ruff]