docs(validation): small things

Author: leandrodamascena

docs/utilities/validation.md

@@ -44,7 +44,7 @@ It will fail fast with `SchemaValidationError` exception if event or response do
 
 === "getting_started_validator_decorator_schema.py"
 
-	```python hl_lines="7 8 10 12 17 19 24 26 28 41 42 44 46 51 53"
+	```python hl_lines="10 12 17 19 24 26 28 44 46 51 53"
     --8<-- "examples/validation/src/getting_started_validator_decorator_schema.py"
 	```
 

examples/validation/src/getting_started_validator_unwrapping_function.py

@@ -8,7 +8,7 @@
 s3_client = boto3.resource("s3")
 
 
-# using a decorator to validate input data
+# we use the 'envelope' parameter to extract the payload inside the 'detail' key before validating
 @validator(inbound_schema=schemas.INPUT, envelope="detail")
 def lambda_handler(event: dict, context: LambdaContext) -> dict:
     my_event = EventBridgeEvent(event)

examples/validation/src/unwrapping_popular_event_source_function.py

@@ -8,6 +8,7 @@
 
 
 # extracting detail from EventBridge custom event
+# see: https://awslabs.github.io/aws-lambda-powertools-python/latest/utilities/jmespath_functions/#built-in-envelopes
 @validator(inbound_schema=schemas.INPUT, envelope=envelopes.EVENTBRIDGE)
 def lambda_handler(event: dict, context: LambdaContext) -> dict:
     my_event = EventBridgeEvent(event)