docs: address last TODOs

Author: heitorlessa

docs/core/event_handler/api_gateway.md

@@ -669,7 +669,9 @@ This will lead to a HTTP 404 despite having your Lambda configured correctly. Se
     ```
 
 ???+ note
-    After removing a path prefix with `strip_prefixes`, the new root path will automatically be mapped to the path argument of `/`. For example, when using `strip_prefixes` value of `/pay`, there is no difference between a request path of `/pay` and `/pay/`; and the path argument would be defined as `/`.
+    After removing a path prefix with `strip_prefixes`, the new root path will automatically be mapped to the path argument of `/`.
+
+	For example, when using `strip_prefixes` value of `/pay`, there is no difference between a request path of `/pay` and `/pay/`; and the path argument would be defined as `/`.
 
 ## Advanced
 
@@ -738,7 +740,7 @@ This will ensure that CORS headers are always returned as part of the response w
     ```
 
 ???+ tip
-    Optionally disable class on a per path basis with `cors=False` parameter.
+    Optionally disable CORS on a per path basis with `cors=False` parameter.
 
 #### Pre-flight
 
@@ -951,7 +953,7 @@ You can enable debug mode via `debug` param, or via `POWERTOOLS_EVENT_HANDLER_DE
 
 This will enable full tracebacks errors in the response, print request and responses, and set CORS in development mode.
 
-???+ warning
+???+ danger
     This might reveal sensitive information in your logs and relax CORS restrictions, use it sparingly.
 
 === "debug.py"

docs/utilities/batch.md

@@ -786,9 +786,6 @@ Inheritance is importance because we need to access message IDs and sequence num
 
 Use the context manager to access a list of all returned values from your `record_handler` function.
 
-##### - TODO - is this a quote or example? is the right place/ fit?
-> Signature: List[Tuple[Union[SuccessResponse, FailureResponse]]]
-
 * **When successful**. We will include a tuple with `success`, the result of `record_handler`, and the batch record
 * **When failed**. We will include a tuple with `fail`, exception as a string, and the batch record
 

docs/utilities/parameters.md

@@ -161,19 +161,16 @@ The AWS Systems Manager Parameter Store provider supports two additional argumen
 | **decrypt**   | `False` | Will automatically decrypt the parameter.
 | **recursive** | `True`  | For `get_multiple()` only, will fetch all parameter values recursively based on a path prefix.
 
-???+ example
-    === "ssm_parameter_store.py"
-
-        ```python hl_lines="6 8"
-        from aws_lambda_powertools.utilities import parameters
+```python hl_lines="6 8" title="Example with get() and get_multiple()"
+from aws_lambda_powertools.utilities import parameters
 
-        ssm_provider = parameters.SSMProvider()
+ssm_provider = parameters.SSMProvider()
 
-        def handler(event, context):
-            decrypted_value = ssm_provider.get("/my/encrypted/parameter", decrypt=True)
+def handler(event, context):
+	decrypted_value = ssm_provider.get("/my/encrypted/parameter", decrypt=True)
 
-            no_recursive_values = ssm_provider.get_multiple("/my/path/prefix", recursive=False)
-        ```
+	no_recursive_values = ssm_provider.get_multiple("/my/path/prefix", recursive=False)
+```
 
 #### SecretsProvider