Adding comprehensive comments

homeassistant/docker-compose.yml

@@ -1,16 +1,25 @@
+# Home Assistant Smart Home Platform Configuration
 services:
   homeassistant:
+    # Basic container configuration
     container_name: homeassistant
     image: docker.io/homeassistant/home-assistant:2025.7.1
     restart: unless-stopped
+    
+    # Persistent storage and system configuration
     volumes:
-      - ${APPDATA_PATH}/homeassistant/config:/config
-      - /etc/localtime:/etc/localtime:ro
+      - ${APPDATA_PATH}/homeassistant/config:/config  # Configuration files
+      - /etc/localtime:/etc/localtime:ro  # Sync host timezone
+    
+    # Network port configuration
     ports:
-      - ${PORT}:8123
+      - ${PORT}:8123  # Web interface port
+    
+    # Network configuration
     networks:
-      - frontend
+      - frontend  # Connects to frontend network
 
+# External network definition
 networks:
   frontend:
-    external: true
+    external: true  # Uses pre-existing frontend network