docs: improving the API reference section

Author: D4Vinci

docs/requirements.txt

@@ -1,5 +1,8 @@
 mkdocstrings>=1.0.0
 mkdocstrings-python>=2.0.1
+griffe-inherited-docstrings
+griffe-runtime-objects
+griffe-sphinx
 mkdocs-material[imaging]>=9.7.1
 black>=25.12.0
 pngquant

mkdocs.yml

@@ -127,11 +127,19 @@ plugins:
             unwrap_annotated: true
             filters:
               - '!^_'
+              - "^__"
             merge_init_into_class: true
             docstring_section_style: spacy
             signature_crossrefs: true
             show_symbol_type_heading: true
             show_symbol_type_toc: true
+            show_inheritance_diagram: true
+            modernize_annotations: true
+            extensions:
+              - griffe_runtime_objects
+              - griffe_sphinx
+              - griffe_inherited_docstrings:
+                  merge: true
 
 extra:
   homepage: https://scrapling.readthedocs.io/en/latest/