Documentation update

Author: JoshCap20

services/device_service.py

@@ -7,7 +7,17 @@
 
 
 class DeviceService:
-    """A service for registering and managing devices."""
+    """
+    A service for registering and managing devices.
+
+    Attributes:
+        session (Session): The database session to use. Injected by FastAPI.
+
+    Methods:
+        register_device(device: Device) -> Device: Register a device.
+        get_registered_devices() -> list[Device]: Get all registered devices.
+        clear_registered_devices() -> None: Clear all registered devices.
+    """
 
     def __init__(self, session: Session = Depends(db_session)):
         """
@@ -44,7 +54,8 @@ def get_registered_devices(self) -> list[Device]:
         return [device.to_model() for device in devices]
 
     def clear_registered_devices(self) -> None:
-        """Clear all registered devices.
+        """
+        Clear all registered devices.
 
         This method deletes all registered devices from the database.
         """

services/push_service.py

@@ -9,14 +9,30 @@ class PushService:
 
     Attributes:
         handler (PushHandler): The handler used to send push notifications. Injected by FastAPI.
+
+    Methods:
+        send_push(message: Message) -> None: Sends a push notification.
     """
 
     def __init__(self, handler: PushHandler = Depends()):
-        """Initialize the Service."""
+        """
+        Initialize the PushService.
+
+        Args:
+            handler (PushHandler): The push notification handler to use. Injected by FastAPI.
+        """
         self.handler = handler
 
     def send_push(self, message: Message) -> None:
-        """Send a push notification."""
+        """
+        Send a push notification.
+
+        Args:
+            message (Message): The message to send.
+
+        Returns:
+            None
+        """
         self.handler.send_multiple_push(
             to_device_tokens=message.recipients, body=message.body
         )