Adding comprehensive comments

gitea-runner/docker-compose.yml

@@ -1,14 +1,20 @@
+# Gitea Actions Runner Configuration
 services:
   gitea_runner:
+    # Basic container configuration
     container_name: gitea_runner
     image: docker.io/gitea/act_runner:0.2.12
     restart: unless-stopped
+    
+    # Runner configuration environment variables
     environment:
-      CONFIG_FILE: /config.yaml
-      GITEA_INSTANCE_URL: "${INSTANCE_URL}"
-      GITEA_RUNNER_REGISTRATION_TOKEN: "${REGISTRATION_TOKEN}"
-      GITEA_RUNNER_NAME: "${RUNNER_NAME}"
+      CONFIG_FILE: /config.yaml  # Path to configuration file
+      GITEA_INSTANCE_URL: "${INSTANCE_URL}"  # URL of Gitea instance
+      GITEA_RUNNER_REGISTRATION_TOKEN: "${REGISTRATION_TOKEN}"  # Registration token
+      GITEA_RUNNER_NAME: "${RUNNER_NAME}"  # Display name for runner
+    
+    # Persistent storage and docker socket configuration
     volumes:
-      - ./config.yaml:/config.yaml
-      - ./data:/data
-      - /var/run/docker.sock:/var/run/docker.sock
+      - ./config.yaml:/config.yaml  # Runner configuration file
+      - ./data:/data  # Persistent runner data
+      - /var/run/docker.sock:/var/run/docker.sock  # Docker socket for container jobs