Adjusted settings to include submodules (#3757)

* Adjusted settings to include submodules

* Update copyright

---------

Co-authored-by: Michael Schuster <[email protected]>

Author: AlexejPenner

docs/mkdocs.yml

@@ -21,14 +21,41 @@ plugins:
         python:
           setup_commands:
             - import docs.sys_modules_mock
-          rendering:
+          options:
+            # Include all public members, not just those in __all__
+            members: true
+            inherited_members: false
+            # Show all submodules automatically 
+            show_submodules: true
+            # Include functions, classes, modules, attributes
+            docstring_style: google
+            # Selection options
+            filters:
+              - "!^_"  # Exclude private members (starting with _)
+              - "^__init__$"  # But include __init__ methods
+              - "^__new__$"   # And __new__ methods
+            # Rendering options
             show_source: true
+            show_root_heading: true
+            show_root_toc_entry: true
+            show_object_full_path: false
+            show_category_heading: true
+            # Group members by category
+            group_by_category: true
+            # Show type annotations
+            show_signature_annotations: true
+            # Show return type annotations
+            show_return_annotations: true
+            # Show the bases of classes
+            show_bases: true
+            # Merge init method documentation into class docstring
+            merge_init_into_class: true
 
 # This setting ensures links don't use directory URLs
 use_directory_urls: false
 
 copyright: >
-  Copyright © 2022 ZenML GmbH –
+  Copyright © 2025 ZenML GmbH –
   <a href="#__consent">Change cookie settings</a>
 
 extra:

docs/mkdocstrings_helper.py

@@ -99,10 +99,10 @@ def create_entity_docs(
                 module_md = (
                     f"# {item_name}\n\n"
                     f"::: {zenml_import_path}.{item.stem}\n"
-                    f"    handler: python\n"
-                    f"    rendering:\n"
+                    f"    options:\n"
                     f"      show_root_heading: true\n"
                     f"      show_source: true\n"
+                    f"      members: true\n"
                 )
 
                 if md_prefix:
@@ -123,8 +123,7 @@ def create_entity_docs(
                         f"# [{item_name}]"
                         f"({index_link})\n\n"
                         f"::: {zenml_import_path}.{item.stem}\n"
-                        f"    handler: python\n"
-                        f"    selection:\n"
+                        f"    options:\n"
                         f"        members: false\n"
                     )
                     index_file_contents.append(index_entry)