Update docs tools (#461)

Author: ssbarnea

.config/constraints.txt

@@ -3,14 +3,14 @@
 argparse-manpage==4.6     # via ansible-compat (pyproject.toml)
 attrs==25.1.0             # via jsonschema, referencing
 babel==2.17.0             # via mkdocs-material
-beautifulsoup4==4.13.0    # via linkchecker, mkdocs-htmlproofer-plugin
+beautifulsoup4==4.13.1    # via linkchecker, mkdocs-htmlproofer-plugin
 black==25.1.0             # via ansible-compat (pyproject.toml)
 cairocffi==1.7.1          # via cairosvg
 cairosvg==2.7.1           # via mkdocs-ansible
 certifi==2025.1.31        # via requests
 cffi==1.17.1              # via cairocffi, cryptography
 charset-normalizer==3.4.1  # via requests
-click==8.1.8              # via black, mkdocs, mkdocstrings
+click==8.1.8              # via black, mkdocs
 colorama==0.4.6           # via griffe, mkdocs-material
 coverage==7.6.10          # via ansible-compat (pyproject.toml)
 cryptography==44.0.0      # via ansible-core
@@ -39,21 +39,21 @@ mkdocs==1.6.1             # via mkdocs-ansible, mkdocs-autorefs, mkdocs-gen-file
 mkdocs-ansible==24.12.0   # via ansible-compat (pyproject.toml)
 mkdocs-autorefs==1.3.0    # via mkdocstrings, mkdocstrings-python
 mkdocs-gen-files==0.5.0   # via mkdocs-ansible
-mkdocs-get-deps==0.2.0    # via mkdocs
+mkdocs-get-deps==0.2.0    # via mkdocs, mkdocstrings
 mkdocs-htmlproofer-plugin==1.3.0  # via mkdocs-ansible
 mkdocs-macros-plugin==1.3.7  # via mkdocs-ansible
-mkdocs-material==9.6.1    # via mkdocs-ansible
+mkdocs-material==9.6.2    # via mkdocs-ansible
 mkdocs-material-extensions==1.3.1  # via mkdocs-ansible, mkdocs-material
 mkdocs-minify-plugin==0.8.0  # via mkdocs-ansible
 mkdocs-monorepo-plugin==1.1.0  # via mkdocs-ansible
-mkdocstrings==0.27.0      # via mkdocs-ansible, mkdocstrings-python
-mkdocstrings-python==1.13.0  # via mkdocs-ansible
+mkdocstrings==0.28.0      # via mkdocs-ansible, mkdocstrings-python
+mkdocstrings-python==1.14.0  # via mkdocs-ansible
 mypy-extensions==1.0.0    # via black
 packaging==24.2           # via ansible-core, black, mkdocs, mkdocs-macros-plugin, pytest, ansible-compat (pyproject.toml)
 paginate==0.5.7           # via mkdocs-material
 pathspec==0.12.1          # via black, mkdocs, mkdocs-macros-plugin
 pillow==11.1.0            # via cairosvg, mkdocs-ansible
-platformdirs==4.3.6       # via black, mkdocs-get-deps, mkdocstrings
+platformdirs==4.3.6       # via black, mkdocs-get-deps
 pluggy==1.5.0             # via pytest
 pycparser==2.22           # via cffi
 pygments==2.19.1          # via mkdocs-material

.config/pydoclint-baseline.txt

@@ -127,12 +127,6 @@ src/ansible_compat/schema.py
     DOC601: Class `JsonSchemaError`: Class docstring contains fewer class attributes than actual class attributes.  (Please read https://jsh9.github.io/pydoclint/checking_class_attributes.html on how to correctly document class attributes.)
     DOC603: Class `JsonSchemaError`: Class docstring attributes are different from actual class attributes. (Or could be other formatting issues: https://jsh9.github.io/pydoclint/violation_codes.html#notes-on-doc103 ). Attributes in the class definition but not in the docstring: [data_path: str, expected: bool | int | str, found: str, json_path: str, message: str, relative_schema: str, schema_path: str, validator: str]. (Please read https://jsh9.github.io/pydoclint/checking_class_attributes.html on how to correctly document class attributes.)
     DOC201: Method `JsonSchemaError.to_friendly` does not have a return section in docstring
-    DOC001: Function/method `validate`: Potential formatting errors in docstring. Error message: Expected a colon in 'SchemaError if the schema is invalid'. (Note: DOC001 could trigger other unrelated violations under this function/method too. Please fix the docstring formatting first.)
-    DOC101: Function `validate`: Docstring contains fewer arguments than in function signature.
-    DOC103: Function `validate`: Docstring arguments are different from function arguments. (Or could be other formatting issues: https://jsh9.github.io/pydoclint/violation_codes.html#notes-on-doc103 ). Arguments in the function signature but not in the docstring: [data: JSON, schema: JSON].
-    DOC201: Function `validate` does not have a return section in docstring
-    DOC501: Function `validate` has "raise" statements, but the docstring does not have a "Raises" section
-    DOC503: Function `validate` exceptions in the "Raises" section in the docstring do not match those in the function body. Raised exceptions in the docstring: []. Raised exceptions in the body: ['jsonschema.SchemaError'].
 --------------------
 test/conftest.py
     DOC101: Function `runtime`: Docstring contains fewer arguments than in function signature.

mkdocs.yml

@@ -41,11 +41,11 @@ plugins:
   - mkdocstrings:
       handlers:
         python:
-          import:
+          inventories:
             - https://docs.python.org/3/objects.inv
           options:
             # heading_level: 2
-            docstring_style: sphinx
+            docstring_style: google
             docstring_options:
               ignore_init_summary: yes
 

src/ansible_compat/schema.py

@@ -81,7 +81,7 @@ def validate(
         Any errors encountered
 
     Raises:
-        SchemaError if the schema is invalid
+        jsonschema.SchemaError: if the schema is invalid
     """
     errors: list[JsonSchemaError] = []