Cleanup and correct doc strings

Author: brefra

plugwise_usb/connection/manager.py

@@ -183,7 +183,7 @@ async def setup_connection_to_stick(
         self._subscribe_to_stick_events()
 
     async def write_to_stick(self, request: PlugwiseRequest) -> None:
-        """Write message to USB stick. Returns the updated request object."""
+        """Write message to USB stick."""
         if not request.resend:
             raise StickError(
                 f"Failed to send {request.__class__.__name__} " +

plugwise_usb/connection/queue.py

@@ -121,7 +121,7 @@ async def submit(
         )
 
     async def _add_request_to_queue(self, request: PlugwiseRequest) -> None:
-        """Add request to send queue and return the session id."""
+        """Add request to send queue."""
         await self._submit_queue.put(request)
         if self._submit_worker_task is None or self._submit_worker_task.done():
             self._submit_worker_task = self._loop.create_task(

plugwise_usb/messages/__init__.py

@@ -21,7 +21,7 @@ def __init__(self, identifier: bytes) -> None:
 
     @property
     def seq_id(self) -> bytes | None:
-        """Return sequence id assigned to this request."""
+        """Return sequence id."""
         return self._seq_id
 
     @seq_id.setter

plugwise_usb/messages/responses.py

@@ -384,7 +384,7 @@ class NodeImageValidationResponse(PlugwiseResponse):
     """
 
     def __init__(self) -> None:
-        """Initialize NodePingResponse message object."""
+        """Initialize NodeImageValidationResponse message object."""
         super().__init__(b"0010")
         self.image_timestamp = UnixTimestamp(0)
         self._params += [self.image_timestamp]

plugwise_usb/network/__init__.py

@@ -364,10 +364,8 @@ async def get_node_details(
         """Return node discovery type."""
         ping_response: NodePingResponse | None = None
         if ping_first:
-            # Define ping request with custom timeout
+            # Define ping request with one retry
             ping_request = NodePingRequest(bytes(mac, UTF8), retries=1)
-            # ping_request.timeout = 3
-
             ping_response: NodePingResponse | None = (
                 await self._controller.send(
                     ping_request