docs: add griffe_warnings_deprecated (#2444)

Author: Kludex

mkdocs.yml

@@ -228,6 +228,10 @@ plugins:
             group_by_category: false
             # 3 because docs are in pages with an H2 just above them
             heading_level: 3
+            extensions:
+              - griffe_warnings_deprecated:
+                  kind: warning
+                  title: Deprecated
           import:
             - url: https://logfire.pydantic.dev/docs/objects.inv
             - url: https://docs.python.org/3/objects.inv

pyproject.toml

@@ -92,6 +92,7 @@ docs = [
     "mkdocs-llmstxt>=0.2.0",
     "mkdocs-material[imaging]>=9.5.45",
     "mkdocstrings-python>=1.12.2",
+    "griffe-warnings-deprecated>=1.1.0",
 ]
 docs-upload = ["algoliasearch>=4.12.0", "pydantic>=2.10.1"]