From: Colin Watson <cjwatson@debian.org>
Date: Sun, 16 Mar 2025 16:17:09 +0000
Subject: Fix documentation build with mkdocstrings 0.29

The previous approach to passing options to `mkdocstrings-python`
started showing deprecation warnings with `mkdocstrings` 0.28.0, and
started failing with `mkdocstrings` 0.28.3.

Forwarded: https://github.com/dgasmith/opt_einsum/pull/250
Bug-Debian: https://bugs.debian.org/1100276
Last-Update: 2025-03-16
---
 docs/requirements.yml |  2 +-
 mkdocs.yml            | 38 +++++++++++++++++++-------------------
 2 files changed, 20 insertions(+), 20 deletions(-)

diff --git a/docs/requirements.yml b/docs/requirements.yml
index b7388ce..a0dfa10 100644
--- a/docs/requirements.yml
+++ b/docs/requirements.yml
@@ -3,7 +3,7 @@ black
 devtools
 markdown==3.*
 markdown-include==0.*
-mkdocstrings[python]==0.25.*
+mkdocstrings[python]==0.29.*
 mkdocs==1.*
 mkdocs-awesome-pages-plugin==2.*
 mkdocs-exclude==1.*
diff --git a/mkdocs.yml b/mkdocs.yml
index c659997..070cbee 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -37,25 +37,25 @@ plugins:
           # paths: [opt_einsum]
           options:
             docstring_style: google
-          docstring_options:
-            ignore_init_summary: true
-          docstring_section_style: list
-          filters: ["!^_"]
-          heading_level: 1
-          inherited_members: true
-          merge_init_into_class: true
-          parameter_headings: true
-          preload_modules: [mkdocstrings]
-          separate_signature: true
-          show_root_heading: true
-          show_root_full_path: false
-          show_signature_annotations: true
-          show_source: false
-          show_symbol_type_heading: true
-          show_symbol_type_toc: true
-          signature_crossrefs: true
-          summary: true
-          unwrap_annotated: true
+            docstring_options:
+              ignore_init_summary: true
+            docstring_section_style: list
+            filters: ["!^_"]
+            heading_level: 1
+            inherited_members: true
+            merge_init_into_class: true
+            parameter_headings: true
+            preload_modules: [mkdocstrings]
+            separate_signature: true
+            show_root_heading: true
+            show_root_full_path: false
+            show_signature_annotations: true
+            show_source: false
+            show_symbol_type_heading: true
+            show_symbol_type_toc: true
+            signature_crossrefs: true
+            summary: true
+            unwrap_annotated: true
 
 extra_javascript:
   - javascript/config.js