Adding documentation

Author: leandrodamascena

docs/core/logger.md

@@ -558,6 +558,31 @@ Use the `@logger.inject_lambda_context` decorator to automatically flush buffere
     --8<-- "examples/logger/src/working_with_buffering_logs_uncaught_exception.py"
     ```
 
+#### Reutilizing same buffer instance
+
+Reuse the same logger instance across multiple files within a service. Doing this you can centralize logger instance creation and prevent buffer configuration drift.
+
+!!! note "Buffer Inheritance"
+    Loggers created with the same `service_name` automatically inherit the buffer configuration from the first initialized logger with a buffer configuration.
+
+=== "working_with_buffering_logs_creating_instance.py"
+
+    ```python hl_lines="5 8"
+    --8<-- "examples/logger/src/working_with_buffering_logs_creating_instance.py"
+    ```
+
+=== "working_with_buffering_logs_reusing_handler.py"
+
+    ```python hl_lines="5 8"
+    --8<-- "examples/logger/src/working_with_buffering_logs_reusing_handler.py"
+    ```
+
+=== "working_with_buffering_logs_reusing_function.py"
+
+    ```python hl_lines="5 8"
+    --8<-- "examples/logger/src/working_with_buffering_logs_reusing_function.py"
+    ```
+
 #### Buffering workflows
 
 ##### Flushing manually

examples/logger/src/working_with_buffering_logs_creating_instance.py

@@ -0,0 +1,5 @@
+from aws_lambda_powertools import Logger
+from aws_lambda_powertools.logging.buffer import LoggerBufferConfig
+
+logger_buffer_config = LoggerBufferConfig(max_size=20480, minimum_log_level="WARNING")
+logger = Logger(level="INFO", logger_buffer=logger_buffer_config)

examples/logger/src/working_with_buffering_logs_reusing_function.py

@@ -0,0 +1,6 @@
+from working_with_buffering_logs_creating_instance import logger  # reusing same instance
+
+
+def my_function():
+    logger.debug("This will be buffered")
+    # do stuff

examples/logger/src/working_with_buffering_logs_reusing_handler.py

@@ -0,0 +1,12 @@
+from working_with_buffering_logs_creating_instance import logger  # reusing same instance
+from working_with_buffering_logs_reusing_function import my_function
+
+from aws_lambda_powertools.utilities.typing import LambdaContext
+
+
+def lambda_handler(event: dict, context: LambdaContext):
+    logger.debug("a debug log")  # this is buffered
+
+    my_function()
+
+    logger.flush_buffer()