From 1b8f7d2b45aa52eabef1efdd4b4fbc5b779fdf75 Mon Sep 17 00:00:00 2001
From: Leandro Damascena <lcdama@amazon.pt>
Date: Fri, 31 Jan 2025 16:22:45 +0000
Subject: [PATCH] Mkdocstrings - Validation module

---
 .../utilities/validation/__init__.py          |  2 ++
 .../utilities/validation/exceptions.py        |  2 +-
 docs/api_doc/validation.md                    |  2 ++
 mkdocs.yml                                    | 19 +++++++++----------
 4 files changed, 14 insertions(+), 11 deletions(-)
 create mode 100644 docs/api_doc/validation.md

diff --git a/aws_lambda_powertools/utilities/validation/__init__.py b/aws_lambda_powertools/utilities/validation/__init__.py
index 45d076ff207..d19581a1258 100644
--- a/aws_lambda_powertools/utilities/validation/__init__.py
+++ b/aws_lambda_powertools/utilities/validation/__init__.py
@@ -1,5 +1,7 @@
 """
 Simple validator to enforce incoming/outgoing event conforms with JSON Schema
+!!! abstract "Usage Documentation"
+    [`Validation`](../utilities/validation.md)
 """
 
 from .exceptions import (
diff --git a/aws_lambda_powertools/utilities/validation/exceptions.py b/aws_lambda_powertools/utilities/validation/exceptions.py
index 9a1c3de22a3..8f8f77df64f 100644
--- a/aws_lambda_powertools/utilities/validation/exceptions.py
+++ b/aws_lambda_powertools/utilities/validation/exceptions.py
@@ -19,7 +19,7 @@ def __init__(
         rule: str | None = None,
         rule_definition: Any | None = None,
     ):
-        """
+        """When serialization fail schema validation
 
         Parameters
         ----------
diff --git a/docs/api_doc/validation.md b/docs/api_doc/validation.md
new file mode 100644
index 00000000000..1cdba7b5fa1
--- /dev/null
+++ b/docs/api_doc/validation.md
@@ -0,0 +1,2 @@
+<!-- markdownlint-disable MD043 MD041 -->
+::: aws_lambda_powertools.utilities.validation
diff --git a/mkdocs.yml b/mkdocs.yml
index f97d46ebc3e..c82b2576e3a 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -62,6 +62,8 @@ nav:
           #     - Overview: contributing/tracks/overview.md
           #     - Casual to regular contributor: contributing/tracks/casual_regular_contributor.md
           #     - Customer to advocate: contributing/tracks/customer_advocate.md
+  - API Documentation:
+      - Validation: api_doc/validation.md
 
 theme:
   name: material
@@ -144,22 +146,19 @@ plugins:
           import:
             - https://docs.python.org/3/objects.inv
           options:
-            # General
-            allow_inspection: true
-            show_source: true
-            show_bases: true
             # Headings
-            heading_level: 2
-            #show_root_heading: false
+            #heading_level: 2
+            #show_root_heading: true
             #show_root_toc_entry: true
             #show_root_full_path: true
             #show_root_members_full_path: false
             #show_object_full_path: false
-            #show_category_heading: true
+            show_category_heading: false
             # Members
-            filters: ["!^_[^_]"]
+            filters: ["!^_"]
             group_by_category: true
-            show_submodules: false
+            members_order: alphabetical
+            show_submodules: true
             # Docstrings
             docstring_style: numpy
             docstring_options:
@@ -168,10 +167,10 @@ plugins:
             merge_init_into_class: true
             show_if_no_docstring: false
             # Signature
-            annotations_path: brief
             show_signature: true
             show_signature_annotations: true
             separate_signature: true
+            summary: true
 
 extra_css:
   - stylesheets/extra.css