docs: cleanup persistence layers attrs, snippet titles etc

Signed-off-by: heitorlessa <[email protected]>

Author: heitorlessa

docs/utilities/idempotency.md

@@ -333,15 +333,13 @@ If an exception is handled or raised **outside** your decorated function, then i
 
 This persistence layer is built-in, allowing you to use an existing DynamoDB table or create a new one dedicated to idempotency state (recommended).
 
-=== "Customizing DynamoDBPersistenceLayer to suit your table structure"
-
-    ```python hl_lines="7-15"
-    --8<-- "examples/idempotency/src/customize_persistence_layer.py"
-    ```
+```python title="customize_persistence_layer.py" hl_lines="7-15"
+--8<-- "examples/idempotency/src/customize_persistence_layer.py"
+```
 
-##### DynamoDB defaults
+##### DynamoDB attributes
 
-When using DynamoDB as the persistence layer, you can customize the attribute names by passing the following parameters during the initialization of the persistence layer:
+You can customize the attribute names during initialization:
 
 | Parameter                   | Required           | Default                              | Description                                                                                              |
 | --------------------------- | ------------------ | ------------------------------------ | -------------------------------------------------------------------------------------------------------- |
@@ -359,34 +357,34 @@ When using DynamoDB as the persistence layer, you can customize the attribute na
 
 !!! info "We recommend Redis version 7 or higher for optimal performance."
 
-For a quick start, initialize `RedisCachePersistenceLayer` and pass your cluster host endpoint along with the port to connect to.
+For simple setups, initialize `RedisCachePersistenceLayer` with your cluster endpoint and port to connect.
 
 For security, we enforce SSL connections by default; to disable it, set `ssl=False`.
 
 === "Redis quick start"
-    ```python hl_lines="7-9 12 26"
+    ```python title="getting_started_with_idempotency_redis_config.py" hl_lines="7-9 12 26"
     --8<-- "examples/idempotency/src/getting_started_with_idempotency_redis_config.py"
     ```
 
 === "Using an existing Redis client"
-    ```python hl_lines="4 9-11 14 22 36"
+    ```python title="getting_started_with_idempotency_redis_client.py" hl_lines="4 9-11 14 22 36"
     --8<-- "examples/idempotency/src/getting_started_with_idempotency_redis_client.py"
     ```
 
 === "Sample event"
 
-    ```json
+    ```json title="getting_started_with_idempotency_payload.json"
     --8<-- "examples/idempotency/src/getting_started_with_idempotency_payload.json"
     ```
 
 ##### Redis SSL connections
 
 We recommend using AWS Secrets Manager to store and rotate certificates safely, and the [Parameters feature](./parameters.md){target="_blank"} to fetch and cache optimally.
 
-For advanced configurations, we also recommend using an existing Redis client for optimal compatibility like SSL certificates and timeout.
+For advanced configurations, we recommend using an existing Redis client for optimal compatibility like SSL certificates and timeout.
 
 === "Advanced configuration using AWS Secrets"
-    ```python hl_lines="9-11 13 15 25"
+    ```python title="using_redis_client_with_aws_secrets.py" hl_lines="9-11 13 15 25"
     --8<-- "examples/idempotency/src/using_redis_client_with_aws_secrets.py"
     ```
 
@@ -400,7 +398,7 @@ For advanced configurations, we also recommend using an existing Redis client fo
     ```
 
 === "Advanced configuration with local certificates"
-    ```python hl_lines="14 25-27"
+    ```python title="using_redis_client_with_local_certs.py" hl_lines="14 25-27"
     --8<-- "examples/idempotency/src/using_redis_client_with_local_certs.py"
     ```
 
@@ -416,9 +414,9 @@ For advanced configurations, we also recommend using an existing Redis client fo
     3. redis_user_private.key file stored in the "certs" directory of your Lambda function
     4. redis_ca.pem file stored in the "certs" directory of your Lambda function
 
-##### Redis defaults
+##### Redis attributes
 
-You can customize attribute names when instantiating `RedisCachePersistenceLayer` with the following parameters:
+You can customize the attribute names during initialization:
 
 | Parameter                   | Required | Default                  | Description                                                                                   |
 | --------------------------- | -------- | ------------------------ | --------------------------------------------------------------------------------------------- |
@@ -427,11 +425,9 @@ You can customize attribute names when instantiating `RedisCachePersistenceLayer
 | **data_attr**               |          | `data`                   | Stores results of successfully executed Lambda handlers                                       |
 | **validation_key_attr**     |          | `validation`             | Hashed representation of the parts of the event used for validation                           |
 
-=== "Customizing RedisPersistenceLayer to suit your data structure"
-
-    ```python hl_lines="9-16"
-    --8<-- "examples/idempotency/src/customize_persistence_layer_redis.py"
-    ```
+```python title="customize_persistence_layer_redis.py" hl_lines="9-16"
+--8<-- "examples/idempotency/src/customize_persistence_layer_redis.py"
+```
 
 ### Common use cases