explain locality

src/tqdm_publisher/_handler.py

@@ -22,6 +22,9 @@ def on_progress_update(progress_update: dict):
             This is the injection called on every update of the progress bar.
 
             It triggers the announcement event over all listeners on each update of the progress bar.
+
+            It must be defined inside this local scope to communicate the `additional_metadata` from the level above
+            without including it in the method signature.
             """
             self._announce(message=dict(**progress_update, **additional_metadata))
 

src/tqdm_publisher/_subscriber.py

@@ -1,4 +1,4 @@
-from typing import Iterable, Any, Dict
+from typing import Any, Dict, Iterable
 
 from ._publisher import TQDMProgressPublisher
 
@@ -13,6 +13,9 @@ def run_on_progress_update(format_dict: Dict[str, Any]):
 
             It calls the `on_progress_update` function, which must take a dictionary
             containing the progress bar ID and `format_dict`.
+
+            It must be defined inside this local scope to include the `.progress_bar_id` attribute from the level above
+            without including it in the method signature.
             """
             on_progress_update(dict(progress_bar_id=self.progress_bar_id, format_dict=format_dict))