chore: add comment describing the decorator check

Author: allenporter

roborock/devices/traits/v1/__init__.py

@@ -46,9 +46,7 @@ class PropertiesApi(Trait):
     def __init__(self, product: HomeDataProduct, rpc_channel: V1RpcChannel, mqtt_rpc_channel: V1RpcChannel) -> None:
         """Initialize the V1TraitProps with None values."""
         self.status = StatusTrait(product)
-        # self.status._rpc_channel = rpc_channel
         self.maps = MapsTrait(self.status)
-        # self.maps._rpc_channel = mqtt_rpc_channel
 
         # This is a hack to allow setting the rpc_channel on all traits. This is
         # used so we can preserve the dataclass behavior when the values in the
@@ -58,7 +56,9 @@ def __init__(self, product: HomeDataProduct, rpc_channel: V1RpcChannel, mqtt_rpc
             if (trait := getattr(self, item.name, None)) is None:
                 trait = item.type()
                 setattr(self, item.name, trait)
-            if hasattr(trait, "mqtt_rpc_channel"):  # @common.mqtt_rpc_channel
+            # The decorator `@common.mqtt_rpc_channel` means that the trait needs
+            # to use the mqtt_rpc_channel (cloud only) instead of the rpc_channel (adaptive)
+            if hasattr(trait, "mqtt_rpc_channel"):
                 trait._rpc_channel = mqtt_rpc_channel
             else:
                 trait._rpc_channel = rpc_channel